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| Preface 


A disk can be either rigid or flexible. A 
flexible, or floppy, disk is a thin, flat 
circle of magnetized material on which 
information from your Apple Il computer 
can be recorded. 


A kilobyte, or 1K, consists of 1024 bytes, 
or 8192 bits. A byte consists of eight bits 
and can hold any value from 0 to 255. 


Random-access memory is memory 
that you can change. When the computer 
is turned off, the contents of RAM are 
erased. 


An application program puts the 
resources and capabilities of the 
computer to use for some specific 
purpose or task, such as word 
processing. DOS is a system program. 
While an application program is used for 
specific tasks, a system program makes 
the computer available for general 
purposes. 


A disk drive writes and reads 
information on the surface of a magnetic 
disk. 
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Introducing DOS 


A disk operating system is a set of computer programs that manages 
information on disks: it lets you store information on disks and read 
the information back into your computer. 


DOS is a specific disk operating system for the Apple Il. Itis a 
manager of information. The information can take the form of 
programs, which perform particular jobs, or data, which can be a 
collection of names or numbers. DOS does not do specific tasks, 
such as helping you create a business letter, keep track of an 
inventory, or create a graph that shows your weight loss. DOS does 
allow you to store and manage such information after you have 
created it. 


DOS 3.3 organizes the space on a disk into 16 sectors. To use a 
13-sector disk with 16-sector DOS, see Appendix A. 


It's a Toss Up: Most people pronounce DOS so it rhymes with “toss.” 
Others spell it out: DEE OH ESS. Use the one that comes easier to you; 
they're both right. 


What Do You Need to Use DOS? 


Before continuing, you should set up your Apple Il computer. See the 
owner's manual that came with your computer for information on 
setting up your system. 


To use DOS, your Apple Il computer should have a minimum of 16 
kilobytes, or K, of random-access memory, called RAM for short. 
DOS uses about 10.5K of memory. To have enough room for DOS 
and an application program, 48K is recommended. 


Your Apple Il computer also must have at least one disk drive. To 
connect your disk drive to your Apple II, follow the instructions that 


came with your disk drive. 


Introducing DOS 


The DOS Manuals 


The DOS User's Manual will guide you step by step through the 
basics of using DOS. If you are learning to program or want to run 
ready-made programs or games, this manual will give you the 
information you need. 


After you've read the material that came with your Apple II computer, 
you are ready for this manual. 


The DOS Programmer's Manual describes more sophisticated DOS 
commands and how to work with complex BASIC programs. After 
you've read this manual and had some experience programming, 
you'll be ready for the programmer's manual. 


The DOS Disks 


The disk labeled DOS 3.3 SYSTEM MASTER contains the DOS 
programs that manage disks and their files. When you use the 
SYSTEM MASTER, the commands and capabilities of DOS are 
added to the other computing capabilities that are already available 
with your Apple II computer. 


The disk labeled DOS 3.3 SAMPLE PROGRAMS contains 
demonstration programs. You will use this disk to learn the DOS 
commands outlined in this manual. 


In addition, the SAMPLE PROGRAMS disk contains examples of 
BASIC programs. For the most part, only a person who is writing 
BASIC programs will want to look at them. 


Ss How This Manual Is Organized 


This manual is for a person who is beginning to use a computer: the 
user who will be running programs that are on disks or writing a 
simple BASIC program. 


Chapter 1, “A Tutorial For New DOS Users,” is designed for you if you 
are anew computer user. If you already have some experience with 
computers, you can begin with Chapter 2 and refer to Chapter 1 only 
occasionally. 


Each chapter in this manual begins with an introduction to the topics 
presented in the chapter. The examples in each chapter are for you to 
work through; trying them will help you learn to use DOS. The end of 
each chapter has a summary of the commands and concepts that are 
covered. 
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Here is an overview of what this manual contains. 


Chapter 1, “A Tutorial for the New DOS User,” includes all you'll 
need to be using DOS within a few hours. Specifically, it tells you 
how to insert a disk into a disk drive, how to start up the computer, 
how to copy a disk for safekeeping, how to prepare a disk to 
receive information, how to work with files on a disk, and how to 
turn the computer off. 


In addition to having a starter set of commands, Chapter 1 
introduces some basic computer concepts and techniques, 
including what a file is, how to load and run a program, how to save 
a file, and how to deal with the unexpected. 


Chapter 2, “An Overview of DOS,” tells what you need to know to 
use DOS. It describes files and how to name them. It explains the 
rules for using DOS commands. 


Chapter 3, “Using Disks,” deals with disks as a whole—finding out 
what is already on a disk, copying an entire disk, and preparing a 
new disk to receive information. 


Chapter 4, “Using Files,” goes into managing individual files: 
keeping track ofthem, renaming them, protecting them from 
accidental erasure, and deleting them. 


Chapter 5, “Using Programs Already on Disks,” discusses using 
application programs: how to run them, and howto save the data 
that they produce. This chapter also covers getting DOS to 
communicate with another device, such as a printer. 


Appendix A, “Dealing With 13-Sector Disks,” guides a user who 
has 13-sector equipment. It describes how to run 13-sector disks 
and how to convert 13-sector disks to a 16-sector format. 


Appendix B, “Warnings and Error Messages,” discusses several 
sources of warnings and error messages. It lists each error 
message from DOS and suggests ways to fix the problem that 
caused the message. 


Appendix C, “Programs on the DOS Disks,” briefly describes each 
program on the SYSTEM MASTER and the SAMPLE 
PROGRAMS disks. 


Appendix D, “Summary of DOS Operating Concepts and 
Commands,” summarizes DOS. You can use this section for quick 
reference later. 


The Glossary defines computer terms with which you may be 
unfamiliar. These terms are boldfaced when they are introduced in 
the text. 
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A A Few Special Notes 


In this manual, Apple ll refers to every model of the Apple II 
computer: the Apple II, the Apple II Plus, and the Apple lle. When the 
information applies only to a specific model, the manual says so. 


The first time computer terms are used in this book, they are defined 
and boldfaced. The terms are also defined in the Glossary. 


The DOS manuals use some special visual aids: 


A special type is used for what you see on your display: 
IT LOOKS LIKE THIS. 


What you should type looks like the keys on the computer's keyboard. 
For instance, when you see 


(RY UYN)GPACE)C\OYLYO\R)GPace) T(ELS\T) 


you should press the corresponding keys on your Apple Il. Although 
the bar isn't labeled on your keyboard, it is important to know 
when you must type a space character, so it is treated as a key. 


When you should press a key that is labeled with two characters, only 
the character you should type is indicated. And is included when 
you must press that key to get the desired character. 


When you see a hyphen joining two keys, it means to press the keys 
simultaneously. For instance, (CONTROL)-(RESET) means you should 
press and at the same time. In actual practice, 

you probably will press first and then, while still holding 
down (CONTROL), press (RESET), 


By the Way: The gray box provides a reminder or additional 
clarification—a faster or better way to do something. 


A Warning 


A box like this indicates a potential problem or disaster. The information in 
the box describes the danger and suggests ways to avoid it. 


Notes in the margins reinforce new 
terms or point to useful information 
contained in other manuals. 
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Chapter 1 


A Tutorial for the New DOS 
User 


This chapter introduces the group of DOS commands you're likely to 
use over and over. It briefly describes what a disk is and how to care 
for it, what a file is, what it means to run and to save a program, and a 
little about how to deal with the unexpected. 


This chapter is presented as a tutorial. Each exercise begins with a 
quick overview of the task. Then the task is presented step by step. 


Start at the beginning, read and try each step of each task asit 
comes along. Go through each of the procedures in succession. By 
the end of the tutorial, you'll know: 

e howto care for disks 

e howto inserta disk into a disk drive 

e howto start up the computer 

e howto copy a disk for safekeeping 

e howto prepare a disk to receive information 

e howto getinformation from a disk 

e howto putinformation on a disk 

e howto run a program 

e howto turn the computer off 

If you have not yet read your owner's manual or the introductory 


material that came with your Apple II computer, take the time to read 
that background material now. 


By the Way: The preceding section, “A Few Special Notes,” describes 
the special notations, such as this box, that are used in this manual. 
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o Getting Started 


DOS, for Disk Operating System, Learning to use DOS means learning a few special commands, like 
is a manager of your disks and the the command CATALOG; a few operations, like inserting and 
information on them. 


removing a disk from a disk drive; and a few new words, like load and 
run. These words are not meant to mystify or impress you. In every 
case, the words are technical terms for which there is no single, 
everyday word. 


DOS helps you control information on disks. That control means you 
can store information on disks and read the information back into 
your computer. What the information is, is up to you. Itcan be a 
A program is a set of instructions program that performs a particular job for you, data such as a 
describing actions for the computer to collection of names or numbers, or just about whatever you like. 
perform to accomplish some task. 
As you work through this tutorial and learn about DOS, you should 
have in front of you: 


e an Apple Il computer with one or two disk drives 
e the DOS 3.3 SYSTEM MASTER disk 

e the DOS 3.3 SAMPLE PROGRAMS disk 

e atleast two blank disks 


The DOS 3.3 SYSTEM MASTER disk is very special. It has the 
programs that make up DOS. You'll be using the SYSTEM MASTER 
disk as you do this tutorial. 


The SAMPLE PROGRAMS disk has demonstration programs and 
games. This chapter will introduce one of its programs to you. 


About Disks and Disk Drives 


A disk drive reads from and writes tothe A disk drive is a little smaller than a shoe box. If you could see 

Surface of a magnetic disk. through its covering, you'd see that it is a magnetic storage device 
with two mechanisms. One mechanism spins the disk. The other 
mechanism reads from and writes to the surface of the disk. 


When the disk drive picks up information from the disk, it functions 

like a record player. However, the information that is picked up from 
the disk goes to the computer rather than to a speaker. A disk drive 
also can record, or write, information from the computer to the disk. 


A flexible, or floppy, disk is used to A flexible disk is small, round, flat, plastic, and about five inches 
Store information. across; it has a hole in the center. Sometimes a flexible disk is called 
a floppy disk. 
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The disk is coated so that information can be stored on its surface. 
The coating is similar to the coating on magnetic recording tape. Be 
careful to protect this coated surface whenever you handle a disk. 


Figure 1-1. A Disk: Plain and Simple. 
Notice the placement of the label. 


Label 


<—— Write-Enable 
Notch 


Center Hole 
Sector-Aligning 


Jacket Hole 


Oval Cutout 


Envelope 


Normally, you can see only a little of the recording surface of the disk 
A disk jacket is a permanent protective because the disk is enclosed in a square, black, plastic jacket 
covering for a disk. Itisusuallymadeof (Figure 1-1). The jacket, which lubricates and protects the disk, has 


Back pias: two cutouts. The larger oval one (about one inch long) is the window 

through which information passes. The smaller square one, the 
Awrite-enable notch permits write-enable notch, allows you to change information on the disk. 
information to be written on the disk. If Without the notch, the computer can only read the information on the 
there is no notch, or it is covered with a disk. 


write-protect tab, information can be read 
from the disk but not written onto it. 
Some disks (like the SYSTEM MASTER) do not have a write-enable 


notch to protect the important information on them. 
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To protect the information on your disks from accidental erasure, you 
Silver write-protect tabs come with can cover the write-enable notch with a write-protect tab. Figure 1-2 


disks and are used to prevent accidental ¡Ilustrates the steps to protect a disk with a write-protect tab. 
erasure of information on the disk 


Figure 1-2. Putting a Write-Protect Tab 
on a Disk. The numbers correspond to 
those in the text. 


1. Find the sticky-backed silver tabs that came in the package with 
your disks. Peel one from its backing. 


2. Put half of the tab on the front of the jacket, covering the write- 
enable notch, and fold the rest of the tab onto the back of the 
jacket. Check that the edges of the tab are smooth. 


Whenever you want to add information to a disk that is write- 
protected this way, you simply remove the silver tab. 


Caring for Disks 


Here is a quick course on the care and handling of disks. This list and 
Figure 1-3 give you some very important guidelines. 


e Handle a disk by its jacket and label. Never remove the disk from 
its jacket. Never touch the surface of the disk itself. Be especially 
careful when labeling a disk not to touch the surface through the 
oval cutout. 


e To write on a label already attached to a disk, use a felt-tip pen. Do 
not press hard. It is better to write on the label before attaching it to 
the disk. 


e Donotwrite on an attached label with a pencil or ball-point pen. 
Doing so may put dents in the recording surface. 


A Tutorial for the New DOS User 


e Donotuse an eraser on the label. Eraser dust is abrasive and can 
damage the disk. 


e When you're not using a disk, keep it in a paper envelope. 


e Store disks upright in their envelopes. Do not bend disks, put them 
into a typewriter, or attach paper clips to them. 


e Store disks away from direct sunlight, moisture, and extremes of 
heat and cold. 


e Keep disks away from magnets and electrical devices, especially 
television sets and large motors. Itis all right to put disks 


Figure 1-3. Four Risky Ways to Handle a temporarily on the computer or disk drive. 


Disk 


Inserting a Disk Into a Disk Drive 


e Lift the small door on drive 1 as shown in Figure 1-4. If there is 
anything in the drive, carefully pull it out and put it in a disk 
envelope. 


Figure 1-4. Opening the Disk Drive Door 
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e Remove the DOS 3.3 SYSTEM MASTER disk from its envelope 
(Figure 1-5). 


Figure 1-5. Removing the Disk From lts 
Envelope 


e Holding the disk with your thumb on the label, gently insert the disk 
into the horizontal slot of drive 1. The disk goes in oval cutout first, 
label up (Figure 1-6). Be careful not to bend or force the disk. If you 
feel any resistance, slowly pull the disk out of the drive and try 
again. 


If a disk has no label, hold the disk so the write-enable notch is on 
the left. 


Figure 1-6. Inserting the Disk Into the 
Drive 
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e When the disk is all the way inside, push the small door on the disk 
drive down until it clicks shut (Figure 1-7). 


Figure 1-7. Closing the Disk Drive Door 


Removing a Disk From a Disk Drive 


When a disk drive's lightis on, DOS is reading or writing to the disk. 
Before you remove any disk from a disk drive, make sure the drive's 
light is off. Then just open the drive door and gently pull the disk out. 
Try it now. 


1. Lift the disk drive door. 
2. Gently remove the SYSTEM MASTER disk from the drive. 


A Warning 
Never remove a disk while the drive's light is on. Doing so may damage 
the disk or garble some of the information on it. 


Sometimes a disk drive won't stop whirring. You can stop a runaway disk 
by pressing and at the same time. 
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Main memory is the part of the Apple II 
computer system that you will use to 
store information. 


A display device exhibits information 
visually. 


Figure 1-8. Turning On the Power 


Starting DOS 


To use DOS, you have to turn on the computer and read DOS from a 
disk into main memory. Reading DOS into memory means that a 
copy of the program containing DOS is put into the computer's 
memory and started up. 


1. Turn on your display device, either a video monitor or a television 
set (with the volume down), so it can warm up. 


2. Check that the SYSTEM MASTER disk is properly inserted in 
drive 1 and that the drive door is closed. 


3. Reach behind the left corner of the computer case and find the 
power switch with your left hand (Figure 1-8). Turn your computer 
on. 


The power indicator on the keyboard and the small light on the 
front of drive 1 will light up. The disk drive will make whirring 
sounds as it reads the disk. After a few seconds, the sounds will 
stop, and the red light on the disk drive will go out. 


If you have trouble, check the next section, “Solving Startup 
Problems,” for what to do. 


The SYSTEM MASTER disk must be in drive 1 to start DOS no matter 
how many drives are connected. 


a 
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When you start DOS successfully, your display screen will look like 
Figure 1-9. This display indicates that DOS is in memory and is ready 
for your commands. If you don't see this display, the next section will 
help you figure out what to do. 


Figure 1-9. The Opening Display 


The DOS version number, and the name 
of the startup disk. 


The actual date of the system program; 
yours may be different. 


The Applesoft BASIC prompt. 


The cursor. 


A Pressing Matter: You'llsee the message BE SURE CAPS 
OW you start DOS on an Apple Ile computer. Press 
(GAPSLOCK) until it clicks into its on, or down, position. 


Ifyou have an Appell ea Plus, you won'tses ints mosens, and 
you don't need to worry about (G4*s tock) 


Starting DOS F | 


Solving Startup Problems 


If the startup procedure didn't work for you, this section will tell you 
what to investigate. The solution to the problem is usually simple. 


Lights or No Lights 
If the power indicators on the computer or display device didn't light 
up, check to see if any of the following apply. 


e Are the power switches of the display device and the computer in 
the on position? 


Is the power cord plugged into the wall socket? Is the power cord 
securely connected to the computer? 


Are you getting power from the wall socket? (Test the outlet with a 
small electric device like a radio.) 

Screen Blank 

If your display screen is blank, check the following. 

e Is the video monitor cable securely connected to the monitor and 
to the computer? 


e Is the brightness adjusted? What about the contrast? 


No Messages or Mysterious Messages 


If you see nothing about DOS on your display screen (only 
APPLE II orperhaps an entirely different message), the 
computer failed to bring DOS into the computer from the disk. 


e Make sure the disk drive is connected properly. 


e Check that the SYSTEM MASTER disk is in drive 1. 


If you have two disk drives and the empty drive keeps spinning (the 
red light stays on, and the drive makes whirring sounds), turn off 
the computer to stop the drive. Your disk drives are labeled 
incorrectly. Switch the labels on the drives; or switch the drives. 
Move the SYSTEM MASTER from drive 2 to drive 1. 


If you see an asterisk (*) on your display, type 


(5) GonTROD)-) 


to start DOS. 
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Read-only memory, or ROM, is memory 
whose contents can only be read. 
Information is written into read-only 
memory once, during manufacture. The 
information is stored permanently and 
can never be erased or changed. 


See Appendix A, “Dealing With 
13-Sector Disks,” for further assistance 
with disks that cause your disk drive 

to continue whirring. 


A prompt character shows that the 
computer is ready for your command. It is 
so named because it prompts, or 
reminds, you that some action is needed. 


If you see an asterisk (*) when you turn on your Apple computer, it means 
you.are in the Monitor program and don't have an autostart ROM. You will 
have to remember to type (s) (Conthot)-(°) whenever you want to start DOS. 
To obtain an autostart ROM, see your dealer. 


Strange Sounds 


If the drive keeps whirring, making strange, dragging noises, try 
opening and then closing the drive door. Make sure that it clicks shut. 
If you have been successful, the drive will make different sounds as it 
reads the disk. 


If the disk drive keeps spinning, stop the drive by pressing 
and at the same time. See the Warning box. When the drive's 
red light goes out, take the disk out, then put it back in. Make sure the 
disk is seated properly in the drive, not curled or on an angle. 


Warning 
Do not try to remove a disk from a drive while its light is on. You may 
damage the disk. 


To stop a runaway disk drive, press and at the same time. 


After you have followed the suggestions for solving your problem, go 
back to “Starting DOS” and try again. 


What Starting Up Is 


Now that you have started up DOS successfully, perhaps you're 
wondering what starting up is and what it does. When you start up 
DOS, you add DOS's commands and capabilities to the computing 
capabilities that are already available with your Apple Il computer. 
The DOS commands are read into memory from the SYSTEM 
MASTER disk. 


Once in memory, DOS starts BASIC, and BASIC prints a prompt 
character (often called a prompt) on the screen. The prompt lets 
you know that the computer is ready for your command. 


When Applesoft BASIC is running, you will see a square bracket (1) 


prompt. When Integer BASIC is running, you will see a greater than 
(>) prompt. 
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A cursor marks where your next action 
will take effect or where the next 
character you type from the keyboard will 
appear on the display screen. 


A catalog is a list of all the files stored on 
a disk. 


Next to the promptis a cursor. The cursor tells you where your next 
command will take place or where the next character you type will 
appear on the display screen. The cursor may be a square, a 
rectangle, a checkerboard box, or a bar; it may blink, or it may glow 
steadily. How it appears depends on the variety of Apple II you are 
using, and the screen width capabilities of your system. 


Restarting DOS 


There may be times when you will want to restart DOS. For instance, 
you will want to restart DOS when your program is doing strange 
things and you can't figure out how to get back to DOS or the prompt; 
or when the monitor is displaying erratic patterns; or when a disk 
drive spins continuously. 


When the power to your computer is on, you can restart DOS by 
holding down and, at the same time, pressing (RESET). Then 
release the keys. DOS is restarted. 


Try it now. You'll hear a beep and then see BASIC's prompt. The 
prompt tells you that you've restarted DOS. 


When you start DOS using (contaoL)-(aesen), the prompt lets you know that 
DOS is ready for your commands. DOS doesn't display the screen shown 
in Figure 1-9. 


This method interrupts the computer and resets it to its original state. . 
It saves time and extends the life of the computer parts. 


If you have a program in memory, this method usually restarts DOS 
without losing your program, whereas turning the computer off and 
then back on always looses what is in main memory. 


Looking at the Contents of a Disk: the 
CATALOG Command 


Once you've started DOS, you can look at the contents of a disk. The 
contents are listed in the disk's catalog. The catalog is simply a list of 
filenames and some information about each file. 


A Note About Spaces: Before you start typing commands and using 
DOS, you need to know about how the computer understands what you 
type. The computer takes everything you tell it literally, and this includes 
the space character. That's right, a space is a character. And when you 
want one, you have to press the bar. Moving the cursor with the 
arrow keys does not insert space characters. 
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The CATALOG command lists the 
contents of a disk. 


For more on the Apple lle keyboard, see 
the owner's manual. 


What You Do... 


1. Make sure the SYSTEM 
MASTER disk in drive 1 and 
DOS is started. 


2. Type (caT aX. ola) 


Look at your display and check 
what you've typed. As long as 
you have not pressed (RETURN), 
you can correct a typing mistake 
by pressing (+) to move the 
cursor back to the mistake. Then 
retype the command. 


Press when you have 
the command typed correctly. 


What You Get... 


You will see BASIC's prompt on 
your screen. 


If you misspell the command and 
press (RETURN), your computer 
will beep, print SYNTAX 
ERROR, and display the 
prompt. Nothing terrible 
happens. Retype the command 
and check the spelling before 
you press (RETURN), 


After a few seconds, you'll see 
the SYSTEM MASTER's catalog 
on your display. 


3. Press the bar to see 
the rest of the catalog. 


Look at your screen. It will look 
like Figure 1-10. 
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Figure 1-10. The Catalog of the SYSTEM 
MASTER Disk. The numbers correspond 
to those in the text. 


A file is a collection of information stored 
on a disk. That information can be text, 
data, or a program. 


To lock a file means to protect it from 
being accidentally changed or erased. To 
unlock a file means to remove that 
protection. 


Chapter 4 discusses how to unlock files. 


For more on file types, see Chapter 3. 


DISK VOLUME 254 
HELLO 
APPLESOFT 
LOADER .0BJ0 
FPBASIC 
INTBASIC 
MASTER 

MASTER CREATE 
COPY 


*B 003 


* 
D 
Sesosossos 
Ssonsnsee 
GIJON 


Figure 1-10 shows the catalog of the SYSTEM MASTER disk. An 
explanation of the catalog follows. 


(T) The first column shows whether the file is locked or not. An 
asterisk (*) means the file is locked. You cannot change the contents 
of a locked file until you unlock it. 


A file that is not locked has a space in the first column instead of an 
asterisk. A space indicates that the file is unlocked and that you can 
change its contents. 


O) The second column shows the file type. The file types that you 
see on the SYSTEM MASTER are 

e Afor“Applesoft” BASIC 

e | for “Integer” BASIC 

e B for “binary” 

File type indicates what language environment you need to be in and 
what commands you need to use to access the files. Certain DOS 


commands work only on certain types of files. You will only be 
working with Applesoft and Integer files in this manual. 
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(3) The third column tells you how big the file is. For example, the file 
Sectors are explained in AppendixBof HELLO is three sectors long. A three-sector file is a small one; a 
the DOS Programmers Manual. 110-sector file is a large one. 


O) The fourth column indicates the name of the file. You'll be using 
some of these files later on. 


Appendix C describes each file on the You will use the programs on the SYSTEM MASTER disk again and 
SYSTEM MASTER. again to manage your disk files. Later in this chapter, you will learn 
how to copy this disk. 


AAA Copy ing the SYSTEM MASTER Disk 


This part of the tutorial shows you how to copy the entire contents of 
the SYSTEM MASTER disk and how to test the copy. 


You should make a backup copy of all The process of making a copy of a disk is called backing up. Once 
rel tare ‘one ld you have made a backup copy of the SYSTEM MASTER, you should 


store the original in a safe place and use the copy. 


A system disk is one that holds the You should do this with all your system disks. Then if something 
Ea application program thatruns happens to the copy, you will still have the original from Apple 
did Computer, Inc. 


Itis also a good idea to protect all your system disks by covering the write- 
enable notch with a silver write-protect tab. See “About Disks and Disk 
Drives” earlier in this chapter for more information. 


To make a copy of a disk, you will use a copy program on your . 
SYSTEM MASTER disk. 


The copy program automatically prepares a blank disk to receive 
information. Then it reads as much information as it can from the 
original disk, putting that information temporarily into main memory. 
The program then writes, or copies, that same information onto the 
blank, or duplicate, disk. Then the program reads more information 
from the original disk into memory before copying it to the duplicate 
disk. 


There can be so much information on a single disk that the copy 


program might repeat this procedure—reading from one disk and 
writing to another—about six times before it makes a complete copy. 
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Use the copy programs on the SYSTEM 


MASTER disk to copy an entire disk. 
COPYA is for Applesoft BASIC users; 
COPY is for Integer BASIC users. 


There are two programs on the SYSTEM MASTER for copying a disk 
as a whole. Both copy programs, called COPYA and COPY, function 
exactly alike. They have different names because they work with 
different languages. You use COPYA (notice the A at the end) when 
your computer is running Applesoft BASIC; you use COPY when 
your computer is running Integer BASIC. 


Remember: You can tell which BASIC you have by looking at the prompt. 
A 1 promptmeans your computer is running Applesoft BASIC;a > 
prompt means your computer is running Integer BASIC. 


Once you have gone through the copy procedure, you'll find it’s easy 
and quick. However, it can be a little confusing the first time through. 
So be sure to follow the instructions carefully. In particular, only press 
when the manual tells you to. 


There are three terms you will see on your display during the copy 
procedure that need some explanation. 


e ORIGINAL refers to the disk you want to copy, in this case, the 
SYSTEM MASTER. 


e DUPLICATE refers to the blank disk that will receive the 
information. 


eo DEFAULT refers to the slot or drive number that will be used if 
you don't specify a different one. 


Note: If you get an unfamiliar message during copying, see “If You Have 
Copying Problems.” 


The copying procedure is divided into two step-by-step sections: one 
for users with one disk drive and one for users with two disk drives. 
Read only the section that applies to you. 


Copying With One Disk Drive 


Two Drive Users: See the section that follows if you have two disk drives. 


What You Do... What You Get... 


1. Insert the SYSTEM MASTER 
disk into drive 1. Check that the 
drive door is completely closed. 
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A default is any value that is 
automatically used by a computer system 
if you don't give another value. Itis the 
computer's best guess. 


An expansion slot is a connector inside 
the Apple Il in which a peripheral card, 
such as a disk controller card, can be 
installed. 


Adisk controller card is a peripheral 
card that connects one or two disk drives 
to the Apple II and controls their 
operation. A peripheral card is a 
removable printed-circuit board that 
plugs into an expansion slot and expands 
or modifies the computer's capabilities. 


2. Look at the cursor and 
determine which BASIC 
language you are using. 


Ifyouseethe J prompt, type 


TOEA Y) 


s, 


Ifyou seethe > prompt, type 


FANE COE) 


3. After checking what you typed 
for errors, press (RETURN), 


4. Press three times to 
accept the values the computer 
assumes you will want. These 
values are called defaults. 


ORIGINAL 


Pressing starts the 
copy program running. You'll 
see APPLE DISK 
DUPLICATION PROGRAM 
on your display. 


You should see this on your 
display screen: 

SLOT: 6 
DRIVE: 1 


DUPLICATE SLOT: 6 
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DRIVE: DEFAULT = 2 


The computer has several 
expansion slots. The copy 
program assumes your disk 
controller card is in slot 6 for 
both the original and duplicate 
disk drives and that you'll be 
using drive 1 for the original disk. 
By pressing three times, 
you accept these default values. 


Figure 1-11. The Slot and Drive Numbers 
for Copying With One Disk Drive 


5. Press (1). This tells the copy 
program that the blank disk, the 
soon-to-be duplicate of the 
original, also will be in drive 1. 


The default is set to 2 in the copy 
program because it’s possible to 
have two disk drives connected 
via the same slot in the 
computer. If you do have two 
drives, you should be reading 
the next section, “Copying 

With Two Disk Drives.” 


Notice that, on your display, 
DRIVE: DEFAULT = 2 
haschangedto DRIVE: 1. 
The copy program is now 
displaying all the slot and drive 
numbers that it will use. 


When the message PRESS 
‘RETURN’ KEY TO 
BEGIN COPY appearson 
the display, it means that the 
program knows where to find the 
information and where to puta 
copy of the information. It has not 
transferred anything from the 
disk yet. 


Your display should look like 
Figure 1-11. Ifyour display does 
not match Figure 1-11, and if you 
are using only one drive, you 
won't be able to copy correctly. 
Press (CONTROL)-(RESET). When 
you see BASIC's prompt, go 
back to step 2. 


APPLE DISK DUPLICATION PROGRAM 


ORIGINAL SLOT 
DRIVE 


DUPLICATE SLOT: 
ES DRIVE: 


-- PRESS ‘RETURN’ 
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6 
1 


6 
1 


KEY TO BEGIN COPY -- 


6. Press to begin the 
copy process. If you get an 
unfamilar message during 
copying, see “If You Have 
Copying Problems.” 


7. Double-check that the 
SYSTEM MASTER is in drive 1. 
Then press to tell the 
computer you have inserted the 
original disk. 
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Pressing tells the 
program to begin. 


You willsee INSERT 
ORIGINAL DISK AND 
PRESS RETURN. This 
message indicates that the 
program is now ready to read 
information from the disk you 
intend to copy. If you wanted to 
copy a disk other than the 
SYSTEM MASTER, you would 
put it into drive 1 at this point. 


Drive 1's light goes on, and you'll 
see READING displayedin 
inverse nextto ORIGINAL 
SLOT: 6. 


This means the copy program is 
reading information from the 
SYSTEM MASTER into the 
computer's main memory, which 
temporarily stores as much 
information as it can. 


Then you'llsee INSERT 
DUPLICATE DISK AND 
PRESS RETURN onthe 
display. This message indicates 
that the program is ready to 
transfer a copy of the information 
ithas temporarily stored in main 
memory to the blank disk. 


8. Carefully remove the 

SYSTEM MASTER from drive 1, 

and put the blank disk into 

drive 1. Then press (RETURN), You'llsee INITIALIZING 
displayed in inverse next to 
DUPLICATE SLOT: 6. 
This means the computer is 
preparing the blank disk to 
receive information. More on 
this later. 


Then you'llsee WRITING 
displayed in inverse next to 
DUPLICATE SLOT: 6. 
This means the program is 
putting a copy of the information 
in main memory on the formerly 
blank disk. 


Finally, you'llsee INSERT 
ORIGINAL DISK AND 
PRESS RETURN. 


9. Exchange the duplicate disk in 
drive 1 for the original (the 
SYSTEM MASTER). 


The SYSTEM MASTER should 
be in drive 1. 


Press (RETURN), You'llsee READING 
displayed in inverse next to 
ORIGINAL SLOT: 6 
and drive 1’s light will go on. 


This means the program is 
reading and temporarily storing 
more information from the 
SYSTEM MASTER. 
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For guidelines on labeling, see “Caring 
for Disks” earlier in this chapter. 


10. Waitfor the message 
INSERT DUPLICATE 
DISK AND PRESS 
RETURN. Then remove the 
SYSTEM MASTER from drive 1 
and insert the duplicate (formerly 
blank) disk into drive 1. 


Press (RETURN). You'll see drive 1's light go on 
and WRITING displayed in 
inverse nextto DUPLICATE 


SLOT? G. 


This means the programis 
putting a copy of the information 
on the duplicate disk. 


11. Repeat steps 9 and 10 until 
you see the message DO 
YOU WISH TO MAKE 
ANOTHER COPY? This prompt indicates that the 
program has finished copying 
the original disk. You now have 
two copies of the SYSTEM 
MASTER disk. Exciting, isn’t it? 


12. Label your new copy 
appropriately. 


Be Persistent: The process with one disk drive takes about six swaps to 
make a copy of the SYSTEM MASTER. How many times you have to 
swap the original disk for the duplicate disk depends on how much data is 
on the original. 
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13. If you would like to make You do not have to enter 
another copy, type) for “yes.” information about the slot and 
Then follow the instructions on drive numbers again. The 

the display. process picks up with step 6. 


If you are going to make a copy 
ofthe SAMPLE PROGRAMS 
disk, cover its write-enable notch 
with a silver write-protect tab. 
Then insertthe SAMPLE 
PROGRAMS disk every time 
the computer prompts you to 
INSERT ORIGINAL 

DISK AND PRESS 
RETURN. 


Ifyou do not want to make You'll see BASIC's prompt on 
another copy type (N) for “no” and your display. 

press (RETURN). Then go on to the 

section “Testing a Copied Disk.” 


Note: It is a good idea, whenever you are copying a disk that has a write- 
enable notch, to cover the notch before copying. That way the original will 
notbe damaged if something goes wrong. Remember, when the notchis 
covered, as with a write-protect tab, information can only be read from the 
disk, not written onto it. 


Copying With Two Disk Drives 


What You Do... What You Get... 


1. Insert the SYSTEM MASTER 
disk into drive 1. Check that the 
drive door is completely closed. 
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A default is any value that is 
automatically used by a computer system 
if you don’t give another value. It is the 
computer's best guess. 


An expansion slot is a connector inside 
the Apple Il in which a peripheral card, 
such as a disk controller card, can be 
installed. 


A disk controller card is a peripheral 
card that connects one or two disk drives 
to the Apple II and controls their 
operation. A peripheral cardis a 
removable printed-circuit board that 
plugs into an expansion slot and expands 
or modifies the computer's capabilities. 


2. Look at the cursor and 
determine which BASIC 
language you are using. 


Ifyouseethe J prompt, type 
(ALU Grace olor Xy La) 
Ifyou see the > 


prompt, type 


3. After checking what you have 
typed for errors, press 
(RETURN), 


4. Press four times to 
accept the values the computer 
assumes you will want. These 
values are called defaults. 


The computer has several 
expansion slots. The copy 
program assumes your disk 
controller card is in slot 6 for 
both the original and duplicate 
disk drives and that you'll be 
using drive 1 for the original disk 


and drive 2 for the duplicate disk. 


By pressing four times, 
you accept these default values. 
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Pressing starts the 
copy program running. You'll 
see APPLE DISK 
DUPLICATION PROGRAM 
on your display. 


The copy program is now 
displaying all the slot and drive 
numbers that it will use. When 
themessage PRESS 

“RETURN” KEY TO 
BEGIN COPY appearson 
the display, it means that the 
program knows where to find the 
information and where to put a 
copy of the information. It has not 
transferred anything from the 
disk yet. 


Your display should look like 
Figure 1-12. If your display does 
not match Figure 1-12, and you 
are using two drives, you won't 
be able to copy correctly. Press 
(CONTROL)-(RESET). When you 

see BASIC's prompt, go back to 
step 2. 


Figure 1-12. The Slot and Drive Numbers 
for Copying With Two Disk Drives 


APPLE DISK DUPLICATION PROGRAM 


ORIGINAL SLOT: DEFAULT = 6 
DRIVE: DEFAULT = 1 
6 


DUPLICATE SLOT: DEFAULT = 
DRIVE: DEFAULT = 2 


-- PRESS ‘RETURN’ KEY TO BEGIN COPY -- 


5. Be sure to insert your original You'llsee READING asthe 

disk in drive 1 and a blank diskin program reads and temporarily 

drive 2 before you press stores information from the 

to begin copying. SYSTEM MASTER in main 
memory. Then you'll see 
INITIALIZING asthe 
computer prepares the blank 
disk to receive the information. 
Then you'llsee WRITING as 
the program puts a copy of the 
information on the duplicate disk. 
And then you'llsee READING 
again as the program reads and 
temporarily stores more 
information from the SYSTEM 
MASTER. The program 
alternately reads and writes until 
all the information is copied onto 
the new disk. 


If you get an unfamilar message 
during copying, see “If You Have 
Copying Problems.” 


When copying is complete, you'll 


see DO YOU WISH TO 
MAKE ANOTHER COPY? 


A Tutorial for the New DOS User 


For guidelines on labeling, see “Caring 
for Disks” earlier in this chapter. 


6. Label your new copy 


appropriately. 

7. If you would like to make You do not have to enter 
another copy, type (Y) for “yes.” information about the slot and 
Be sure to put another blank disk drive numbers again. The 

in drive 2, and then follow the process picks up with step 5. 
instructions on the display. 


If you are going to make a copy 
of the SAMPLE PROGRAMS 
disk, cover its write-enable notch 
with a silver write-protect tab. 
Then insert the SAMPLE 
PROGRAMS disk in drive 1. 


If you do not want to make You'll see BASIC's prompt on 
another copy, type (N) for “no” your display. 

and press (RETURN). Then go 

on to the section “Testing a 

Copied Disk.” 


Note: It is a good idea, whenever you are copying a disk that has a write- 
enable notch, to cover the notch before copying. That way the original will 
not be damaged if something goes wrong. Remember, when the notch is 
covered, as with a write-protect tab, information can only be read from the 
disk, not written onto it. 


If You Have Copying Problems 


Youmaygetan ***** UNABLE TO READ ***** or 
1/0 ERROR message if the SYSTEM MASTER is not in drive 1, 
if the disk isn’t completely inserted, if the door to drive 1 isn’t 
completely closed, or if you indicated the wrong slot or drive number. 


You may getan ***** UNABLE TO WRITE ***** or 
1/0 ERROR message if your duplicate disk isn’t properly seated 
in the disk drive, if the duplicate disk is write-protected (see the 
section “About Disks and Disk Drives”), if the drive door isn’t 
completely closed, or if you indicated the wrong slot or drive number. 


If COPYA cannot read from the source disk or write to the duplicate 
disk, you'llbe asked DO YOU WISH TO MAKE ANOTHER 
COPY”. Type (N) for “no” and press (RETUAN). You'll see the Applesoft 
BASIC prompt. 
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Chapter 3 has more on slot and drive 
numbers. 


See "Looking at the Contents of a Disk: 
the CATALOG Command" for more 
information. 


You should always test your copies. 


If COPY cannot initialize the duplicate disk, you'll see 1/0 
ERROR and then the Integer BASIC prompt. If COPY cannot 
transfer the information, you'llbe asked DO YOU WISH TO 
MAKE ANOTHER COPY? Type(N) for “no” and press (RETURN). 
You'll see the Integer BASIC prompt. 


Now, before you try to copy again, check to see that 


e your SYSTEM MASTER disk is properly inserted in drive 1 
e the drive door(s) is completely closed 


e the blank disk you are using for copying has a write-enable notch 
(and it is not covered with a write-protect tab) 


e you are using the correct slot and drive numbers 


e you are following the instructions in “Copying With One Disk 
Drive” if you have one drive or in “Copying With Two Disk Drives” if 
you have two drives. 


After you have checked these things, go back to step 2 of the 
appropriate section and try again. 


If you keep having problems, its possible that the blank disk is faulty. 
As alast resort, try another blank disk. 


If you still cannot copy a disk, contact your Apple dealer. 


Testing a Copied Disk 

After you have copied a disk, it is a good idea to check the copy. 

If the duplicate disk is not a system disk, you can do this by checking 
the catalog. If you get a listing and it is the same as that of the original, 


you have a good copy. If you get an error message, or if the catalog is 
incomplete, try the copy procedure again. 


Remember: You type 


0000000 

and press to get a listing of a disk. 
If the new disk is a system disk, you should check the disk by: 
restarting the computer with the copy. For instance, to make sure that 


your copy of the SYSTEM MASTER is good, try to start DOS with the 
new disk. 
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Two restart methods are described in this section. The method you 
use depends on the kind of Apple Il computer you have. Other 
methods are discussed in Chapter 5. 

e |f you have an Apple lle, both procedures will work. 


e |f you have an Apple II or Apple II Plus, only the second procedure 


will work. 
You can restart the Apple lle without You can restart an Apple lle computer without turning the computer 
turning the computer off and then on off and then on again. This method saves time and extends the life of 


nae the computer's mechanical and electronic parts. 


What You Do... What You Get... 


1. Place the new copy of the 
SYSTEM MASTER in drive 1 
and close the drive door. 


If you have questions about the Apple lle 2. Press (©) and (CONTROL). Hold You'll see drive 1's light go on 


keyboard, see the owner's manual. them down while you press and hear the disk drive start up. 
(RESET). After a bit, the whirring will stop 


and the light will go out. 

Let go of (RESET), then (CONTROL), 

and then release ©). If the SYSTEM MASTER has 
been copied accurately, you'll 
see DOS's opening display 
(Figure 1-8.) If you don't, your 
disk may not be a good copy of 
the SYSTEM MASTER. Go back 
to the appropriate section in 
“Copying the SYSTEM MASTER 
Disk” and make a fresh copy. 


The previous method of restarting the computer only works with the Apple 
lle, which has ©. 
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You can use the next procedure to restart all three kinds of Apple II 
computers (Apple II, Apple II Plus, and Apple lle). Remember, 
successfully starting the program on the new disk proves that the disk 
is good. 


What You Do... What You Get... 


1. Reach behind the left rear 
corner of the computer. Find the 
power switch with your left hand 
and turn it off. (If you need help 
finding the power switch, see 
Figure 1-8.) 


2. Place the new copy of the 
SYSTEM MASTER in drive 1 
and close the drive door. 


3. Now, turn the computer on. You'll see drive 1's light go on 
and hear the drive start up. After 
a bit, the whirring will stop and 
the light will go out. 


If the SYSTEM MASTER has 
been copied accurately, you'll 
see DOS's opening display 
(Figure 1-8.) If you don't, your 
disk may not be a good copy of 
the SYSTEM MASTER. Go back 
to the appropriate section in 
"Copying the SYSTEM MASTER 
Disk” and make a fresh copy. 


If you have an asterisk on your display, Remember that if you see an 


a ree or hs asterisk (*), you'll have to type 
in “Solving up 
Problems” earlier in this chapter. (6) (ConTROL)-(P) to start DOS up 
after you turn the computer on. 
See Chapter 5, “The PR# Command” 
and “Other Ways to Start DOS,” for more 
ways to restart the computer. 
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A Preparing a Blank Disk: the INIT Command 


Now that you've learned how to start DOS and how to copy 
everything on one disk to a new disk, it is time to prepare a blank disk 
so it can receive information. 


When you buy blank disks, they have nothing recorded on them— 
just like blank tape for a tape recorder. Before a blank disk can 
receive information from DOS, you must prepare it using the INIT 


Initializing, also called formatting, command. This preparation process is called initializing or 
means to prepare a disk to receive formatting. 
information. 


You use two distinct operations to prepare any blank disk. The 


The INIT command prepares the disk first is to write a greeting program; the second is to issue the INIT 
and puts DOS and the greeting program command. 
on the disk. 


The greeting program is called by that name since it greets you: each 
time you start the disk, the program will be run automatically. The 
greeting program is commonly named HELLO. It helps keep life 
simple to use a standard name for greeting programs as you initialize 
disks. 


This section explains how to create a greeting program for initializing 
your blank disks. The content of such a program can (and does) vary. 
Sometimes hello programs contain a single line. Sometimes—as on 
the DOS 3.3 SYSTEM MASTER disk—they are quite complex. 


A Warning 
When you initialize a disk, everything on the disk is erased. 


Follow these steps to initialize a disk: 


What You Do... What You Get... 


1. Remove the SYSTEM 
MASTER disk from drive 1; puta 
blank disk into drive 1 and close 
the door. Be sure the write- 
enable notch is not covered. 


Preparing a Blank Disk: the INIT Command 


The NEW command clears main 
memory for a new program. 


PRINT is a BASIC command. It is used to 
print. Whatever you type in quotation 
marks after PRINT will be displayed 
when the program is run. 


The END command ends a program. 


2. Type 
OB 


and press to erase 
anything that might be in main 
memory. 


3. Now type this short program. 
Press after you have 
typed each line correctly. 
Substitute your name and 

the actual date when you 

type line 20. 


Type the spaces and quotation 
marks carefully. Remember, you 
can use the (+) key to back the 
cursor up and correct any 
mistakes before you press 


(RETURN). Your display should look like this: 
109 PRINT "THIS HELLO PROGRAM CREATED BY" 
20 PRINT "(your name) ON (date)" 

30 END 


This program will be used by the 
INIT command to prepare the 
blank disk. Then, each time this 
disk is started up, the program 
will be run. 


4. Test your program by typing You'll see the lines you just typed 


appear on the display. 
000 


and pressing (RETURN), 


A Tutorial for the New DOS User 


See Chapter 3, “The INIT Command," 
for how to specify a volume number. 


A sector is a fixed portion of the disk. 
Initializing divides the disk in tracks and 
sectors. See the DOS Programmer's 
Manual for more on sectors. 


A disk envelope is a protective paper 
sleeve. 


5. Now type 
000063068000 
and press (RETURN). 


HELLO is the name of the three- 
line program you just wrote. INIT 
is a DOS command that, when 
used in combination with a 
program name, tells the disk 
operating system to initialize 
the blank disk. INIT puts HELLO 
on the disk and makes it the 
greeting program that DOS 

will run each time that disk is 
started up. 


6. To test the disk to make sure it 
is, in fact, initialized, type 


0COUDBOO 


and press (RETURN). 


7. Carefully remove the disk from 
the drive and attach a label. See 
Figure 1-1 for the location of 

the label. You may want to note 
on the label that the disk is 
initialized. Keep the diskina 
disk envelope to protect it from 
dust when you are not using it. 


Preparing a Blank Disk: the INIT Command 


When the disk drive quiets down, 
the light goes off, and the prompt 
appears, initializing is complete: 
DOS initialized the disk. 


Ifyougetan 1/0 ERROR 
message, check the disk and the 
disk drive; then type the INIT 
command again. 


You should see a short catalog 
like this: 


DISK VOLUME 254 
A 002 HELLO 


DOS assigned your disk the 
volume number 254 (which it 
always does unless you specify 
a different number) and wrote 
your BASIC program on it. The 
program, as you can see from 
the catalog, is two (002) sectors 
long, and is named HELLO. 


Transferring a copy of the information on 
a disk into memory is known as loading. 


Changing or modifying information in 
memory is known as editing. 


Transferring a copy of the information in 
memory to a disk is known as saving. 


` 


The disk you've just prepared and tested is ready to use with DOS. 
You can use it to hold programs, data, text, graphics, or whatever 
information you'd like. Leave the write-enable notch of this disk 
uncovered so that you can write to and save information on the disk. 


Any disk that has been initialized is memory-size dependent: the size of 
the system that initializes the disk determines the size of the system that 
can use the disk. If the disk is initialized on a 32K system, then the disk 
can only be used on a system with 32K or more of memory. 


Using Programs 


Some programs, like games, run automatically when you start the 
disk drive. They take care of just about everything for you— 
displaying instructions, following your orders, bringing in information 
from the disk, and saving information on the disk. 


However, some programs require you to know how to do some of this 
work. In particular, you need to know how to bring information from a 
disk into the computer's memory (called loading); how to change 
information while it is in memory (called editing); and how to save 
information from the computer's memory onto a disk (called saving). 


You also need to know how to instruct the computer to perform these 
functions if you plan to do any programming. This part of the tutorial 
explains loading, editing, and saving information. 


Reading Information From a Disk: the LOAD 
Command 


To look at the contents of a file that is stored on a disk, you must first 
bring a copy of the information in the file from the disk into the main 
memory of the computer. This procedure is called loading and is 
accomplished with the LOAD command. 
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LOAD is a DOS command that finds the 
named BASIC program on the disk and 
puts a copy of that program into the 
computer's main memory. 


The LIST command shows a listing of the 
program in memory on the display. 


What You Do... 


1. Putthe SAMPLE 
PROGRAMS disk in drive 1. 


2. Type 
000030680000 
008 

and press (RETURN). 


3. To look at this program, type 
0000 


and press (RETURN), 


What You Get... 


The disk drive will work away as 
DOS finds VERIFY.ME and puts 
a copy of it in main memory. 


When the program is in memory, 
you'll see BASIC's prompt again. 


Ifyousee FILE NOT 
FOUND, type the command 
again. Note that the dot is part of 
the filename; be sure and type it. 


You'll see the contents of 
VERIFY.ME, which is only one 
line: 


10 REM VERIFY,ME 


Memory Isn't Permanent: Information brought into memory from a disk 
is erased from main memory when you turn off the computer. However, 
only a copy is put in memory, so you still have the information on the disk 


whenever you need it. 
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Changing the Contents of Memory 


To change the information saved in a file you must first load a copy of 
the contents into the computer’s memory. Since you have already 
loaded the VERIFY.ME program into memory, it is handy to use for 
learning how to make changes to something in memory and how to 
save the new version. 


Files and Memory: A file is a collection of information stored as a named 
unit on a peripheral storage device, such as a disk. In other words, the 
term file is only used to refer to something on a disk. When that same 
information is put into memory, itis no longer called a file, but a document, 
aprogram, a picture, a worksheet, data, or whatever. 


What You Do... What You Get... 


1. Remove the SAMPLE 
PROGRAMS disk from the disk 
drive and insert the disk you just 
initialized into drive 1. 


2. To make sure you have You'll see that the HELLO 

inserted the correct disk, type program is the only program on 
your disk. 

and press (RETURN). 

3. Type You'll notice that a copy of 
VERIFY.ME is still in memory, 

0080 unless you have turned off your 
computer, in which case you 

and press (RETUAN), should load the program again. 


As you see, the contents of 
VERIFY.ME consist of one line. 


10 REM VERIFY,ME 
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4. Now add another line to the 
program so your display looks 
like this: 

20 PRINT "NEW LINE" 


and press (RETUAN), 


5. Add one more line: 
30 END 


and press (RETURN), 


6. To check the new program, 
issue the LIST command and 
press (RETURN), 


Pressing adds line 20 
to the VERIFY.ME program that 
is stored in the computer's 
memory. It does not, however, 
change the copy of the program 
that is on the disk. 


This line also is added to the 
program in memory. 


The program now in memory is 
displayed: 


10 REM VERIFY,ME 
20 PRINT "NEW LINE" 
30 END 


You have now changed the contents of the program in memory by 
adding two lines to it. So long as you leave your computer on, and do 
notissue a NEW command or replace those lines with some others, 
the program VERIFY.ME will remain in the computer's memory. To 
keep the program so you can use it over and over, you must put a 
copy ofiton a disk. The next section shows you how to save your 


program. 
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SAVE puts a copy of the BASIC program 
in memory onto a disk. 


Saving Information On a Disk: the SAVE Command 


Putting a program into a file on a disk stores it permanently—or at 
least until you change its contents. The SAVE command allows you to 
save any changes that you've made to a program (for example, a new 
date in a greeting program); information that you've added to a 
program (for example, a new entry in a phone list); and whole new 
programs that you've written. 


Whenever you save information, you must use a disk that you can 
write on, that is, one that is not write-protected. Use the disk you just 
initialized for the following procedure. 


What You do... What You Get... 


1. To put a copy of the program in 
memory on your disk, type 


If you see the message 
SYNTAX ERROR, try again, 
making sure that you are using 


160066300000 uppercase and that you haven't 
fEad0800006 made any typos. 
and press (RETURN), The disk whirs as DOS copies 


the information in memory, a 
program, to a disk file named 
PROOF POSITIVE. 


The revised program (lines 
10-30) is still in memory, and now 
itis also on disk. 


Note: You have to type a space character between PROOF and 
POSITIVE if you want the filename to be two words. Remember that to the 
computer a space is a character just like any letter or number. If you want 
a space character, you must press the bar. 


2. To check that the program 
was saved on the disk, issue the 


Your display should look like this: 


CATALOG command and press DISK VOLUME 254 
(RETURN), 
A 002 HELLO 


A 002 PRODF POSITIVE 


Seeing PROOF POSITIVE is 
indeed proof that you have 
successfully saved the program 
in memory to a file on the disk. 
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3. Type Main memory is cleared. If you 
issue a LIST command, all you 

MEW will get is BASIC's prompt. You 
can now start another program 

and press (RETURN). or load something from a disk. 

4. To double-check your new DOS brings a copy of the 

program, type program you just saved from the 
disk into memory. 

BOOK ez3B0008 

(SPACEY POLS UYE) 

and press (RETURN), 

5. Type The listing of PROOF POSITIVE 
is displayed. 

0000 

and press (RETURN). 


By the Way: The original one-line program VERIFY.ME is still on the 
SAMPLE PROGRAMS disk. You saved the three-line version with a 
different name, PROOF POSITIVE, so now you have both versions safely 
stored on disk. 


Whenever you change a program, if you want to keep both versions, you 
must save the new version under a different filename. If you use the same 
filename for both versions, the new version will be written over the old 
version, and the old version will be lost. 
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The RUN command finds a BASIC 
program on the disk, puts a copy into 
memory, and starts the program running. 


A menu is alist of choices. 


Running a Disk Program: the RUN Command 


Many programs do not run automatically when you start the disk. To 
execute such programs, you use the DOS command RUN. 


What You Do... What You Get... 


1. Remove your initialized disk 
from the disk drive. Insert the 
SAMPLE PROGRAMS disk into 
drive 1. 


2. Type DOS finds, loads, and starts the 
program called COLOR TEST. 
You'll see COLOR TEST's menu 


els) of demonstrations. 
and press (RETURN). 


3. COLOR TEST lets you adjust 
the colors on your color screen. 
Even if you don’t have a color 
screen, you'll see a two-tone 
display. The program gives you 
instructions on your screen. To 
operate the demonstration, type 


0,8, @, or 


and press (RETURN), The demonstration begins. 


4. To end demonstration 1, 2, 3, You'll see the menu again. 
or 4 and return to the menu, 


press (RETURN), 

5. To quit using the COLOR You'll see BASIC's prompt on 
TEST program, type your display again. 

6). 
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The RUN command is the command that you'll use again and again 
to start programs running. If you want to try it out again, there are 
several interesting programs on the SAMPLE PROGRAMS disk. 


Some older models of the Apple II may not be able to run COLOR TEST, 
and you will see the message LANGUAGE NOT AVAILABLE. If 
so, try running the APPLEVISION program. Then follow that program's 
instructions. 


AA Turning Off the Computer 


You are finished with the tutorial. All you need to do is turn off the 
computer. Follow these steps: 


1. Remove the disk and close the door of your disk drive. Carefully 
put all your disks away. 


2. Reach behind the left rear corner of the computer. Find the power 
switch with your left hand. Turn it off. 


3. Turn off your video monitor or TV set. 


This ends the tutorial. If you feel you need more practice with the 
commands and programs in this chapter, go ahead and play 
around with them. If you're feeling adventurous, try to run a few 
demonstration programs on the SAMPLE PROGRAMS disk. Check 
Appendix C for an explanation of the programs on the DOS disks. 
Feel free to try those that look interesting to you. 


When you're ready to move on, Chapter 2 begins the reference 
section of this manual with an overall picture of DOS—what happens 
behind the scenes when you start DOS and how DOS relates to the 
other programs that come with your computer. 


Turning Off the Computer 


E Chapter 1 Summary 
This tutorial has taken you through the basics of using DOS. In 
addition to all the new terminology, you've learned how to 
take care of disks 
start up your computer with DOS 


look at the contents of a disk by using the CATALOG command 
copy a disk with the copy programs on the SYSTEM MASTER disk 


test a disk copy by checking the disk’s catalog or by seeing if the 
disk can restart the computer 


o 
o 
e insert and remove a disk from a disk drive 
o 
o 
o 


e create a greeting program for a blank disk 


e prepare a blank disk to receive information by using the INIT 
command 


e transfer a copy of the contents of a file from a disk by using the 
LOAD command 


e save the information in memory to a disk by using the SAVE 
command 


e start a program that's stored on a disk by using the RUN command 
e turn off the computer 


That's quite a lot; give yourself a pat on the back. 
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Chapter 2 


An Overview ofDOS 


DOS is a program, or set of instructions, that keeps track of your disk 
files, handles the flow of information between disks and memory, and 
takes care of many other housekeeping tasks. The DOS program is 
on the SYSTEM MASTER disk. 


This chapter begins the reference part of this manual. It describes 
how DOS works and the form, or syntax, used by DOS commands. It 
also explains how files and volumes relate to each other and to DOS. 


It's important to understand how DOS fits in with other programs in 
your Apple II computer. What happens when you start DOS? How do 
you identify the information you want to work with? How do you know 
that DOS is ready to obey your commands? You will find most of the 
answers in this chapter. 


If you have worked through the tutorial (Chapter 1), you may have 
some questions about how DOS works. This chapter will try to 
answer those questions. 


How DOS Works 


When you start DOS, you add the DOS commands and capabilities to 
the computing powers already available with your computer. Once 
you have brought the DOS program into your computer's memory, 
you can run programs that are stored on disks, and you can save 
information and programs on a disk. 


You must bring DOS into memory each time you start the system and 


want to use disks. To use DOS, you give it instructions in a form that 
DOS accepts. 


How DOS Works 


The Monitor program is a system 
program built into the Apple II. It 
supervises main memory. 


Aperipheral device is used in 
conjunction with a computer. It is often 
separate from the computer, and itis 
typically connected by means of a 
peripheral card. 


Main memory is the part of the Apple II 
computer system that you will use to 
store information. 


If you want to know more about the 
Monitor program, see the reference 
manual for your computer. 


The disk containing DOS must be in drive 
1 to start up the operating system 
program. 


The Monitor Program 


The Monitor program is a built-in computing capability. The program 
is always present and acts as a supervisor, controlling all other 
programs. One of its tasks is starting the resident BASIC. Another 
task is reading DOS into memory. The Monitor program resides in its 
own part of memory, separate from the areas in which BASIC and 
DOS reside. 


The Monitor program also controls communication between the 
keyboard and the display, and between your Apple computer and 
peripheral devices, such as disk drives and printers. 


The Monitor program reads DOS into memory and then lets DOS 
control communication. 


The Startup Process 


When you turn on your Apple computer, several electrical and 
mechanical events take place to bring DOS into main memory. 


As soon as the computer recognizes that it has power, it checks to 
see if a disk drive is connected. If a drive is connected, the computer 
tries to bring the information on the disk in drive 1 into memory. These 
actions are performed by the Monitor program. 


If the disk in drive 1 contains DOS, DOS is transferred into memory 
and started by the Monitor program. When the disk in drive 1 is the 
DOS 3.3 SYSTEM MASTER, you get the opening display 
announcing DOS (Figure 2-1), and DOS tries to bring into memory 
the alternate BASIC. DOS then gets BASIC running. 
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Figure 2-1. The Opening Display 
The DOS version number, and the name 
of the startup disk. 


The actual date of the system program; 
yours may be different. 


The Applesoft BASIC prompt. 


The cursor. 


The prompt character, or prompt, is BASIC prints its prompt character, often called the prompt, on the 
used by the computer to let you know that i i 

kle fadi lor your command, Ile also display to let you know the computer is ready for your command. 
used to identify the program or meena 

component of the system that is doing the Ifyou have an Apple II, you may have an older version of the Monitor 


prompting. program that does ude autostart. When you start DOS, all you'll 
see on your displ: asterisk (*). 
To begin the startup process described here, you'll have to type 
(6) (GonTROL)-(P) i 


You will have to do this every time you want to start up DOS. 
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Figure 2-2 illustrates the steps in the startup process. 


Figure 2-2. The Startup Process 


1. Monitor program brings DOS into memory and starts it. 


2. DOS notes the size of memory and checks to see if the alternate 
BASIC is available. 


3. DOS runs HELLO, its startup program. 


4. If your computer's memory is large enough, DOS puts the 
alternate BASIC in memory. 


5. DOS starts BASIC. BASIC prints its prompt. 
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An expansion slot is a connector inside 
the Apple Il in which a peripheral card, 
such as a disk controller card, can be 
installed. 


A disk controller card is a peripheral 
card that connects one or two disk drives 
to the Apple II and controls their opera- 
tion. A peripheral card is a removable 
printed-circuit board that plugs into an 
expansion slot and expands or modifies 
the computer's capabilities. 


The startup drive is the disk drive the 
computer checks first for a system disk. 


A startup disk has the information 
necessary to set the system in operation. 
Itis sometimes called a boot disk. 


The INIT command is used to initialize, 
or format, a disk so that it can receive 
information. See Chapter 3 for more on 
the INIT command. 


Hardware refers to those components of 
a computer system consisting of physical 
(electronic or mechanical) devices. 


Firmware refers to those components of 
a computer system consisting of 
programs stored permanently in read- 
only memory. 


The Startup Drive 


The autostart ROM in the Apple II computer looks for and tries to read 
from the highest-numbered expansion slot, beginning with slot 7. 


When slot 7 is empty, the autostart ROM tries to read from slot 6. 
Your disk controller card should be in slot 6. 


In addition, your first disk drive's cable should be attached to the 
drive 1 connector of the controller card, the second disk drive's cable 
should be attached to the drive 2 connector. 


That way, turning on your computer causes the information on the 
disk in drive 1 to be put into memory. And, accordingly, drive 1 is 
known as the startup drive. 


If you do not know which disk drive is drive 1, and itis not labeled, you 
can determine the startup drive by turning on the computer and 
watching to see which disk drive's light comes on first. The first drive 
the computer looks in is the startup drive, or drive 1. 


Startup Disks 


A startup disk is set up so that it automatically runs one of its 
programs when read. The DOS command INIT designates a startup 
disk. A startup disk contains all the information that the computer 
needs to bring the program from the disk into memory and start the 
program running. The SYSTEM MASTER and the SAMPLE 
PROGRAMS disks are both startup disks. They automatically start 
the DOS program. 


Starting versus Booting: This manual uses the term startup instead of 
boot. Other manuals may tell you to boot your system or boot a disk. Don't 
let the difference in terminology throw you, the two terms mean the same 
thing. 


Boot came from the word bootstrap, which describes something that 
appears to use its own action to start operating. 


Two BASIC Languages 


What language you can use depends on the size of your Apple 
computer and what hardware and firmware it has. Many Apple II 
computers are equipped to use both BASIC languages: Integer and 
Applesoft. 
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Resident means the language is stored 
permanently in the computer. 


Read-only memory is memory whose 
contents can only be read. Itis used for 
storing firmware. The contents can never 
be erased or changed, unless you 
physically remove the integrated circuit. 


Random-access memory is memory 
whose contents you can read from or 
write to. The information in RAM is 
erased when the computer is turned off. 


An integrated circuit, or chip, is an 
electronic component made up of many 
circuit elements fabricated on a single 
piece of silicon. 


The LANGUAGE NOT 
AVAILABLE messageis explained in 
Appendix B. 


A file is a collection of information stored 
as a named unit on a storage medium 
such as a disk. 


A volume is a collection of all the files on 
astorage medium. 


The BASIC that is available when you turn on your computer is called 
the resident language. lt starts automatically when the system 
starts. The Apple II computer has Integer BASIC in ROM, which 
stands for read-only memory. The Apple II Plus and the Apple lle 
computers have Applesoft BASIC in ROM. 


If you have an Apple II or Apple II Plus computer, you can add a language 
card to increase the size of random-access memory, or RAM. A 
language card cannot be used in an Apple lle. 


When you start up your system and when it has enough memory (at 
least 64K) for both BASIC languages, DOS brings a copy of the 
nonresident, or alternate, BASIC from the disk and puts it in the 
additional RAM of an Apple II or in a language card, if you have one. 


When you start DOS, it reports which BASIC it is bringing into 
memory. When Applesoft BASIC is resident, you will see the 
message LOADING INTEGER BASIC INTO MEMORY. 
When Integer BASIC is resident, you willsee LOADING 
APPLESOFT BASIC INTO MEMORY. When your Apple 
computer does not have enough temporary storage space for the 
alternate BASIC, you do not see any message. 


Files and Volumes 


This section describes files and volumes and their relation to disks. 
It also covers the general rules for naming files. 


Files 


DOS organizes the information on each disk, or volume, into units of 
disk storage known as files. For the sake of analogy, you can think of 
disk files as manila folders in the drawer of a filing cabinet. Each 
folder contains a particular kind of information. 


For instance, a drawer labeled “Personnel” might have one folder 
with information on full-time employees organized by name, another 
folder with comparative salary data by position, and another folder 
with the formulas for calculating taxes. 


If you were going to computerize your file cabinet, the drawer 
“Personnel” would become the volume PERSONNEL and each 
folder would become a file and be appropriately, and uniquely, 
named: for instance, EMPLOYEES, SALARY, and TAXES. 
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Any kind of information can be stored in a file, including telephone 
lists, memos, recipes, pictures, programs, and data. 


The important difference between folders and files is efficiency. 


e Disk files can store large amounts of information in a small space. 


e Disk files can be accessed and changed quickly. 


File types are listed in Chapter 3. Each file must have a name and a type. When you want to use the 
information stored in a particular file, you must refer to that file by its 
name. The file's type indicates the kind of information the file 
contains. You must know the file's type to use the correct DOS 
commands. 


A catalog is like a table of contents for a On each disk, DOS keeps a list, or catalog, of all the files—their 

disk. names, theirtypes, their size, and their location. Figure 2-3 diagrams 
a catalog that keeps track of the files in PERSONNEL. Each of these 
files can be any file type. 


A catalog can have entries for 105 files. In actual practice, however, a 
disk usually runs out of storage space before the catalog reachesits 
limit. 


Figure 2-3. Files in a Catalog 
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A filename is the unique name under 
which a file is stored. 


The INIT command is used to initialize, 
or format, a disk so that it can receive 
information. See Chapter 3 for more on 
the INIT command. 


Filenames 


DOS creates and polices files by using filenames. A filename can 
have up to 30 characters. The first character must be a letter; the rest 
of the name can contain any character you can type except a comma. 
Each filename on a particular disk must be unique. 


Here are a few examples of legal filenames. Note that spaces and 
periods can be used to separate parts of a filename. 


e A SOMNAMBULIST RUNNING RAMPANT is an example of 
the longest possible name. 


e Zisan example of the shortest possible name. 


e A.1DERFUL.NAME.3 is an example of how to use letters, 
numbers, and periods in a filename. 


DOS ignores any characters typed after you reach the 30-character 

limit. For instance, if you type the filename TWO.SOMNAMBULISTS. 
RUNNING.RAMPANT, which is 33 characters long, DOS shortens it to 
TWO.SOMNAMBULISTS.RUNNING.RAMP, which is 30 characters long. 
DOS does this automatically and does not print an error message. But as 
long as you don’t make a typing error, and as long as the shortened name 
is unique, DOS will still find your file even when you type all 33 characters. 


DOS has three don'ts when naming files: 
e Don'tbegin a filename with a number: 2HT2HL is an unacceptable 


filename. 


e Don't begin a filename with a period: PRINTER is an 
unacceptable filename. 


e Don'tuse a comma in a filename: BOOP,BETTY is an 
unacceptable filename. 


If you use an unacceptable filename, DOS displays the SYNTAX 
ERROR message. 


Volumes 


The collection of all the information placed on a disk is called a 
volume. You can identify a volume with a number and use that 
number to make sure that DOS is working with the correct disk. 


The volume number is assigned when you prepare a disk to receive 
information with the INIT command. No DOS command requires a 
volume number, although you do have the option of specifying a 
number when the disk is initialized. Otherwise, DOS assigns the 
default number, 254. 
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An argument is a value the command 
uses. It can be required or optional. 


Figure 2-4. The Syntax of DOS 


DOS commands, like the words used in programming languages, 
must follow certain rules. Some of the rules, like the spelling of a 
command, always apply. Other rules, like using a drive number with a 
command, only apply in certain circumstances. This section covers 
the general rules that apply to DOS commands. 


Most DOS commands may be issued not only from the keyboard but also 
from within a program. This manual covers issuing DOS commands only 
from the keyboard. The DOS Programmer's Manual describes issuing 
DOS commands from programs. 


Syntax 


The syntax (the order and form) of the various parts of aDOS 
command is expressed in a kind of shorthand, which is described 
here: 


UPPERCASE indicates the actual name of something, like a 
DOS command. Type it exactly as indicated. 

lowercase indicates something you supply, like the name 
of a program. 

fn indicates a filename that you supply. 

[ ] indicates an optional argument in a command. 


You may include the option or not, as you 
choose. In any case, don’t type the brackets. 


n indicates a number you supply. 


All the possible forms of each DOS command are presented ina 
one-line description of the command, as in Figure 2-4. 


Commands 
Syntax Examples 
Arguments 
AAN 
COMMAND fn [,Sn] [,Dn] [, Vn] SAVE ELEGANT.CODE, 
MM Volume Number D2 
Drive Number DELETE BOOKS» 56» 
Slot Number Dis, Y3 
Command Filename RUN WHIZBOOM+ Di 
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A default is a value used by DOS when 
no other value is specified. (That is, the 
value is used by default.) 


The default disk drive is the one that was 
last used. 


In Figure 2-4, COMMAND represents any DOS command (for 
example, SAVE, DELETE, or RUN) and fn, [,Sn], [,Dn], and [, Vn] are 
the command's arguments. The brackets indicate that the argument 
is optional. 


Options 


An argument within brackets is called an option, something you can 
omit or include when you give a command. Use a comma to separate 
an option from the preceding argument. You may put a space before 
or after the comma. Type the uppercase letter to identify which option 
you are using. When n is used with the argument, you must supply a 
number. 


Warning 


The square bracket notation is used in this manual only to indicate that an 
argumentis optional. When you type a DOS command, do not type the 
brackets. 


Defaults 


When you don’t tell DOS anything one way or another about an 
optional argument, DOS makes an assumption. This assumption, 
which is called the default, is what DOS uses when no other value is 
explicitly given. 


DOS defaults to the disk drive, slot, and volume used during the 
startup process. Normally, this means that the defaults are 

e drive 1 

e slot6 

e volume 254 


DOS uses these defaults until you indicate a different drive, slot, or 
volume number. Then DOS defaults to that number. 


For example, when you start up DOS, drive 1 is the default (DOS 
must always be started from drive 1). If you issue a CATALOG 
command, DOS will list the contents of the disk in drive 1. If you want 
to see the catalog of the disk in drive 2, you must type 


ADALAT 


And once you have used drive 2, DOS assumes that you want to 
keep using that drive. So, drive 2 becomes the default until you 
specify otherwise. 
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An integer is a whole number, a number 
with no fractional part. 


A hexadecimal number is expressed in 
terms of powers of sixteen, using the 
sixteen digits 0 to 9 and A to F. 


An argument is a value the command 
uses. It can be required or optional. 


The default works in the same manner with the slot number. Slot 6 
(assuming that’s the slot where DOS found your disk controller card) 
is the default until you tell DOS to use another slot. 


If, for example, you type 


CO00000AS8E 


DOS would look in slot 5 for a disk controller card. Ifitfound one, 
DOS would give you a catalog of the disk in drive 2 (the most recently 
specified). And from then on DOS would use slot 5 as the default 
value for the slot option. To change the default back to slot 6, drive 1, 
you would have to use those values in another command, such as 
CATALOG+S6+D1. 


Changing Defaults: When you want to change the default value, you 
must tell DOS explicitly. Include the argument in the next appropriate 
command. 


Numbers 


This manual uses a lowercase n in syntax notation to indicate that 
you should use an actual number as part of the argument. 


For example, the notation [,Dn] means you should substitute the 
number of the disk drive you want when you type the argument, as in 


000 

or 

808 

You can use an integer or a hexadecimal number for the number. 


Usually an integer is used. If you want to use hexadecimal numbers, 
refer to the DOS Programmer's Manual. 


The Arguments 


The four arguments—fn, [,Sn], [,Dn], and [,Vn]—are used to specify 
the filename, slot number, drive number, and volume number, 
respectively. Together they identify the file you want to use. The 
arguments in square brackets are optional. When you don't use an 
optional argument, DOS uses the default, as previously explained. 
You may use the slot number, drive number, and volume number 
arguments in any order. For example, W36+D2 +56 worksthe 
sameas 56 +D2 +36. 
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Chapter 5 describes how to use the slot 
number argument to send information to 
aprinter. 


A controller card is a peripheral card 
that connects a device, such as a printer 
or a disk drive, to the computer and 
controls the operation of the device. 


Filename: fn 


In syntax notation, fn stands for “filename.” Nearly all DOS 
commands must be followed by a filename. In other words, they 
require this argument. You should supply the name of the file you 
want as the first argument after the DOS command. 


If the default disk drive is the one you want to use, all you need to do 
is type the command and the filename. For instance, in the 
commands 


SAVE PROGRAM 
and 
RUN OLD+HAT 


DOS would assume the default for slot, drive, and volume numbers. If 
the default drive was drive 2, both commands would use the disk in 
drive 2. You can see how using the default can be a handy shortcut. 


Note: DOS will always assume that the first argument in a command is 
the filename. 


Slot Number: [,Sn] 


The optional slot number argument is used to specify a particular 
expansion slot number in DOS commands. 


When you use this option, replace the n with an actual number from 1 
to 7. The value you specify becomes the default slot number. That is, 
DOS uses this slot number until you specify a different one. 


If you don't specify a slot number, DOS looks in the most recently 
used slot. If you never specify a slot number in a given session with 
DOS, DOS uses the slot from which you started DOS. 


You would be mostlikely to use the slot number argument if you have 
more than one disk controller card or if you have a printer controller 
card. 


If you have two disk controller cards, the slot number argument is 
essential to differentiate between your disk drives. If, for example, 
you have two controller cards with four disk drives connected, they 
would be identified as follows: 


e drive1: +56+D1 e drive3: +S5,D1i 
e drive2: +S6+D2 e drive4: »S5;+D2 
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This argument is also useful for accessing printers and for 
transferring information between devices connected to the computer 
via expansion slots. 


When You Don't Have to Specify a Slot Number: If you are using only 
one or two disk drives and you do not have any other peripheral devices 
connected to your Apple computer, you don't have to specify a slot 
number in your DOS command. As long as you don’t specify a different 
number, DOS assumes you will want the slot number you used when you 
started up your system. 


Drive Number: [,Dn] 


The optional drive number argument specifies the number of the disk 
drive that holds the disk you want to use. 


When you use this option, replace the n with a drive number, 1 or 2. 
When you omit the drive number argument, DOS uses the drive that 
was last used. If you never specify a drive number in a given session 
with DOS, DOS uses the drive number of the startup drive. 


Here are some DOS commands that use the slot and drive options: 


CATALOG D2 displays the catalog of the disk in 
drive 2. DOS uses the slot it used 
last. 


RUN WHIZBOOM +56 +Di reads the program WHIZBOOM 
from the disk in drive 1 
connected to the disk controller 
card in slot 6 and runs the 
program. 


When You Don't Have to Specify a Drive Number: If you are using one 
disk drive and do not have any other peripheral devices connected to your 
Apple computer, you don't have to specify a drive number. As long as you 
don't specify a different number, DOS assumes you will want the drive 
number you used when you started up your system. 


Volume Number: [,Vn] 


The optional volume number argument specifies the number of the 
volume, or disk, you want to use. Although you can use the volume 
number argument with most DOS commands, it is rarely used. 


If you do use this option, replace n with an actual volume number 
from 1 to 254. Once you specify a number, it becomes the default 


volume number. 
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The INIT command is discussed in 
Chapter 3. 


See Chapter 5 for ways to restart DOS. 
Appendix B lists all DOS error messages 


and suggests ways to fix what caused the 
message. 


DOS assigns a default volume number of 254 to a disk when it is 
initialized with the INIT command unless you specify a different 
volume number. 


When you give other DOS commands, if you do not specify a volume 
number, if you specify volume number 0, or if you type (V) without a 
number, DOS will assume that whatever volume number is on the 
disk is the one you want. 


Here is an example of aDOS command that uses the volume option: 


LOAD DICE» V21 DOS checks to see if the number 
of the disk in the default disk 
drive is 21. If itis 21, DOS reads 
the program DICE from that 
volume into memory. 


Error Messages From Bad Arguments 


If you make an error when using arguments, you might get one or 
more of these messages: 


e The RANGE ERROR message indicates that you used a slot 
number larger than 7 or a drive number other than 1 or 2. 


e The VOLUME MISMATCH message indicates that you 
specified a volume number that DOS can't find. This message 
allows you to retype the command with the correct number before 
DOS exercises your command on the wrong disk. 


e The 1/0 ERROR message can indicate several things: 


You may get it because the specified disk drive's door is open. 
Close the door and try the command again. 


You may get it because a connection is loose. Check to see if the 
disk drive cables are securely connected and that the controller 
card is properly inserted in the expansion slot. 


You may get it if you have specified a slot that doesn't contain a 
controller card. lf a named slot doesn't have a controller card, the 
system may stop, and you will loose whatever you have in 
memory. If this is the case, you must restart DOS. 
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A Chapter 2 Summary 


In this chapter, you learned how DOS works and the form, or syntax, 
used by DOS commands. You also learned how files and volumes 
relate to each other and to DOS. 


And you found out what happens when you start DOS and how DOS 
fits in with other programs in your Apple II computer. 
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Chapter 3 


Using Disks 


This chapter discusses how to manage disks. It will explain how to 
geta listing of the files that are on a disk, copy the contents of entire 
disks, prepare a disk for DOS, and determine the current slot and 
drive numbers. These topics are covered more comprehensively 
than in Chapter 1. 


AAA The CATALOG Command 


A catalog is a list of all the files storedon The listing of the contents of a disk is called a catalog. When you 
adisk. issue a CATALOG command, alist is displayed of all the files on a 
disk with a few statistics about each one. 


In addition to the file’s name, the catalog shows whether a file is 
locked, what its type is, and its size. 


On the disk, the catalog is a series of file entries that contain the 
name, location, and characteristics for each file. A disk’s catalog has 
room for 105 file entries. Usually, the disk runs out of file space before 
the disk's catalog fills up. 


When a catalog is longer than the display can show at one time, you 
must press a key to continue the listing. Pressing the bar to do 
this is a good habit to get into. If you want to see the beginning of the 
catalog again, issue another CATALOG command. 


An explanation of the syntax notation in The command has this syntax: 
this manual can be found in Chapter 2, 


“DOS Commands.” CATALOG [,Sn] [,Dn] 


If you include a volume number argument in the CATALOG 
command, DOS will ignore it. If you do not use the slot number (Sn) 
and drive number (Dn) arguments with the CATALOG command, 
DOS uses the default values, which are the numbers of the disk drive 
and slot last specified. 
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Reminders: 


e DOS commands must be typed in uppercase. If you are using an 
Apple lle computer, press until it locks into its “on” position. 


e Press after you have typed the command and corrected any 
mistakes. 


For instance, if you have DOS running and you want to see the 
contents of the SAMPLE PROGRAMS disk, put the SAMPLE 
PROGRAMS disk in drive 1 and type 


OOVOBOGEZ3 00 


Notice that you do not need a comma in this command when you use 
only one argument. 


In response to this command, your display will fill with the catalog of 
the SAMPLE PROGRAMS disk (Figure 3-1). Press the bar to 


continue the catalog. 

Figure 3-1. The Catalog of the SAMPLE 
PROGRAMS Disk. When a catalog is DISK VOLUME 254 
longer than one screen can hold, you : 
should press bar to continue the s A pag EEI FT 
listing. The numbers in the figure corre- *B 006 LOADER., 0BJØ 
spond to those in the “Understanding a *B 042 FPBASIC 
Catalog” section. *B 042 INTBASIC 

*I 018 ANIMALS 


RANDOM 
003 APPLE PROMS 
007 ADDRESS 

003 BLACK BOOK 

003 ONERR DEMO 

002 LOCKED.UP.1 
002 LOCKED.UP.2 
LOCK.ME.1 


kkk OK 


* 
DDDDDDDDDDD DAD 
a 
Ss 
N 


* KK 


008 MAKE TEXT 
GET TEXT 


ii 
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The LOCK and UNLOCK commands are 
explained in Chapter 4. 


File types are defined in Table 3-1. 


A sector holds 256 characters. The 
DOS Programmer's Manual has more on 
sectors. 


Table 3-1. File Types. File types 
determine the form of DOS commands 
necessary to access a file and, in some 
cases, which of two similar programs to 
use. The languages available ina 
particular system determine whether 
Integer files, Applesoft files, or both can 
be used. 


For an explanation of the files on the 
SAMPLE PROGRAMS disk, see 
Appendix C. 


Understanding a Catalog 


The following is an explanation of the parts of a catalog. The numbers 
correspond to those in Figure 3-1. 

O Volume Number The number assigned to the disk when 
initialized, the volume number, is shown in 
the catalog's heading. 


Reading left to right across the catalog: 


(2) Lock Status The first column indicates whether or not the 
file is locked. An asterisk (*) indicates that a 
file is locked, or protected, and you cannot 
change its contents until you unlock that file. 

O) File Type The one-letter code in the second column 


indicates the file type. 
(4) File Size The third column shows the number of 
sectors the file uses. 


Note: If an individual file exceeds 255 sectors, the display of file size 
starts over at 000. This does not affect the use of the file, but gives a 
misleading impression of the size of the file. 


6) Filename The last column shows the filename. 

File Type Code Used With 

Applesoft BASIC A Applesoft BASIC; Created By SAVE 
Binary B Binary Commands; Created By BSAVE (*) 
Integer BASIC l Integer BASIC; Created By SAVE 

Text E Text File Commands; Created By OPEN (*) 
Relocatable R Assembly Language (+) 

Unused S Reserved for Future Use 


* See the DOS Programmer's Manual 
+ See the 6502 Assembler/DOS Tool Kit 
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AAA The Copy Programs 


There are two similar programs that copy a whole disk. Which one 
you use depends on which BASIC you are using. The COPYA 
program is used when you are running Applesoft BASIC. The COPY 
program is used when you are running Integer BASIC. 


A Warning 


The copy programs begin by initializing the duplicate disk. If any 
information is on the disk, it will be erased. 


Chapter 1, the tutorial, has step-by-step The copy programs start by asking about slot and drive numbers. 
instructions for using the copy programs That is, before using a default slot or drive number, the program 
with one or two disk drives. ; e 
checks with you. It displays a default number that you can accept by 
pressing or you can type the number you want. 


A Word to the Wise: It is strongly recommended that you make at least 
one backup copy of your SYSTEM MASTER disk. Put the original 
SYSTEM MASTER in a safe place (someday you may want to copy it 
again) and use the copy. 


To write-protect a disk means to prevent Write-protect the copy by covering the write-enable notch with a silver 
any new information from being written write-protect tab. 

onto it. This is accomplished by covering 
the disk's write-enable notch with a 
write-protect tab. See Chapter 1. 


The COPYA Program for Applesoft BASIC 


When you're running Applesoft BASIC, use the COPYA program to 
copy the entire contents of a disk to a blank disk. You can tell you are 
using Applesoft bythe [ prompt. 


To use the COPYA program on the SYSTEM MASTER, type 
(RUN) GPACECLOLPIVIAL IO) 

After the program is read into main memory, the display will show 
APPLE DISK DUPLICATION PROGRAM andthe default 


values for slot and drive numbers for the original and duplicate disks. 


In this program, the disk that is copied is called the original disk; the 
copy is called the duplicate disk. 


If you do not know which slot your disk controller card is in, you can run the 
SLOT# program, which is discussed later in this chapter. Or you can open 
the computer and see for yourself—check your owner's manual. 
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If you want to accept the default value, press (RETURN). If you want a 
slot or drive number other than that shown, type the number. Then 
press when you are ready to begin copying. 


Ifyou are using one disk drive, the computer will tell you when to 
switch between original and duplicate disks. If you are using two or 
more drives, put the original in drive 1, the duplicate in drive 2, and 
accept all the default values. You will not have to move any disks 
during the process. 


The program will advise you of its progress with the messages 
INITIALIZING, WRITING, and READING. Whenthe 
copy is completed, you will be asked if you want to make another 
copy. If you type (N) for “no,” you will leave the copy program, and the 
prompt will return. 


If you want to make another copy, type (Y) for “yes,” and the program 
will start over. 


If you want step-by-step instructions for using the copy programs with 
one or two disk drives, see Chapter 1. 


Before copying any original disk, it's good practice to protect the 
contents from being erased accidentally. Write-protect the disk. 


The COPY Program for Integer BASIC 

When you're running Integer BASIC, use the COPY program to copy 
the entire contents of a disk to a blank disk. You can tell you are using 
Integer BASIC bythe > prompt. 

To use the COPY program on the SYSTEM MASTER, type 

000 

And follow the messages on the display. The COPY program 
functions exactly like the COPYA program. Refer to the previous 
section for details. 


If you want step-by-step instructions for using the copy programs with 
one or two disk drives, see Chapter 1. 
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Error Messages From the Copy Programs 


Depending on the program you are using, you may see 

XXX UNABLE TO READ ***x*x* (COPYA) or 

IZO ERROR STOPPED AT (line number) (COPY) 
if there is no disk in the drive specified, if the disk isn't completely 
inserted into the drive, if the door to the drive isn't fully closed, or if 
you indicated the wrong slot or drive number. 


Depending on the program you are using, you also may see 

XXX UNABLE TO WRITE ***** (COPYA) or 

1/0 ERROR STOPPED AT (line number) (COPY)if 
your duplicate disk isn’t properly seated in the disk drive, if the 
duplicate disk has no write-enable notch or the notch is covered, if the 
drive door isn't fully closed, or if you indicated the wrong slot or drive. 


If COPYA cannot read from the source disk or write to the duplicate, 
you'llsee DO YOU WISH TO MAKE ANOTHER COPY? 
Type (N), press (RETURN), and return to BASIC. If COPY reports 

1/0 ERROR, itreturns to BASIC. 


If COPY cannot initialize the duplicate disk, you'llsee 1/0 
ERROR and then the Integer BASIC prompt. If COPY cannot 
transfer the information, you'llbe asked DO YOU WISH TO 
MAKE ANOTHER COPY? Type(N for “no” and press (RETURN), 
You'll see the Integer BASIC prompt. 


Before you run the copy program again, check your SYSTEM 
MASTER disk, the duplicate disk and its write-enable notch, and your 
slot and drive numbers. 


One More Possibility: There is another, but slower, way to copy an entire 
disk. Use the FILEM program. FILEM is useful when you want to copy a 
single file or a set of files that have similar names, like FOO, FOO1, and 
FOO2. 


FILEM is discussed in Chapter 4. 
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When you initialize a disk, you prepare it 
to receive information by dividing its 
surface into tracks and sectors. 


A master disk is not memory-size 
dependent. 


DOS puts 35 circular bands, or tracks, 
on a disk when it initializes it. Each track 
is divided into 16 sectors. 


Preparing Disks 


There is no information at all on a new disk, fresh from the 
manufacturer. To use a disk with DOS, you must put special 
information on it. Placing this information on the disk is called 
initializing, or formatting. 


You can prepare a disk two different ways to receive information: you 
can simply initialize the disk or you can make it a master disk. 


Initialized Disks 


An initialized disk is prepared with the INIT command. The command 
organizes the surface of the disk into tracks and sectors so it can 
receive information, and it puts a copy of DOS and a greeting 
program on that disk. 


Any disk that has been initialized is memory-size dependent: the size 
of the system that initializes the disk determines the size of the 
system that can use the disk. 


For example, if a disk is initialized on a 32K system 
e ¡tcan only be used on a system with 32K or more of memory 


e itwill not execute programs that together with DOS use more than 
32K of memory (since DOS uses 10.5K of memory, other 
programs can use up to 21.5K) 


If you will be using an Apple system with the same memory size 
every day, disks initialized disk on your system will serve you very 
satisfactorily. However, if you can use a disk initialized on a smaller 
system (for example, if you borrow a friend's disk), you may get an 
OUT OF MEMORY message. 


By the Way: In some manuals, an initialized disk is called a slave disk 
because it is chained to the size of the computer in which it was prepared. 


Master Disks 


A master disk has a self-relocating DOS that uses memory efficiently 
on any size system. That is, each time you start up a master disk, 
DOS is put as high as possible into memory. That way, a larger block 
of memory is available for your program. 


Master disks, unlike initialized disks, are not memory-size 
dependent. They can be run on systems with various memory sizes. 
The SYSTEM MASTER is an example of a master disk. You can runit 
on any Apple computer. 


Preparing Disks A 


The MASTER program is described in 
the DOS Programmer's Manual. 


If you have two or more Apple computers with different memory 
sizes, you may wish to convert your initialized disks to master disks 
using the MASTER program. 


Greeting Programs 


All disks that have been initialized with DOS have a greeting 
program. The contents of that program can vary from a simple 
INITIALIZED DISK CREATED ON MY BIRTHDAY 
to a complex program that runs automatically when the disk is 
started up. 


When you want a simple greeting program, you can copy an existing 
one from a disk, or you can write a new one. 


You can put whatever information you want in a greeting program. 
Since itannounces the disk, itis handy to include 


e The date you initialize the disk 
e Thesize of the system you are using 
e A message to make you smile whenever you use the disk 


To write your own greeting program, clear main memory by issuing a 
NEW command, and then type a BASIC program to display whatever 
message you want. For example: 


10 PRINT "MERRY CHRISTMAS!" 
20 PRINT "G4K DISK INITIALIZED 25 DECEMBER 1983" 
30 END 


Incidentally: You may use whatever name you like for the greeting 
program. Since a greeting progrm looks like any other program in a 
disk's catalog, it helps to use a standard name for all your greeting 
programs. In this manual, HELLO is used as the standard name. 


Once you have created a greeting program, you use the INIT 


command to put the greeting on the disk and to complete the 
initializing procedure. 
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The INIT command initializes a disk. 


A turnkey program runs automatically 


when the disk is started. For more 


information, see the DOS Programmer's 


Manual. 


A 


The INIT Command 


The INIT command is used to create an initialized disk that you can 
use with DOS. The command organizes the surface of the disk into 
tracks and sectors and puts a copy of DOS and a greeting program 
on that disk. 


When initializing is complete, DOS does not display any confirming 
message; you just see the prompt again. However, you can now use 
this disk to start DOS up, and DOS can now write to and read from 
the disk. 


When an initialized disk is started, DOS checks the directions INIT 
stores on the disk and runs the program that they point to. For 
example, when those directions point to a greeting program, the 
greeting message from the program is displayed. When the 
directions point to some other program (perhaps a game program 
or application program), that program starts running. A program 
that is started automatically is called a turnkey program. 


An initialized disk is reusable. When you no longer need the 


information on a disk, you can reinitialize it. This erases any 
information on the disk and gives you a fresh start. 


Warning 

When you initialize a disk, anything stored on it is erased. Make sure you 
do not initialize a disk that contains information or programs you want to 
save. 


Use the INIT command only in immediate execution; that is, directly 
from the keyboard. 


The command has this syntax: 

INIT fn [,Sn] [,Dn] [,Vn] 

When you replace fn, which stands for “filename,” with the name of a 
program that is currently in memory, DOS puts the program on the 


specified disk. 


For example, if the three lines of the Christmas greeting program 
from the previous section were in memory, you would simply type 


0000306000 


and DOS would put that program on the disk in the default drive. 
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If there is no program currently in memory, DOS creates an empty file 
on the disk. 


The slot, drive, and volume arguments are optional. When you omit 
the slot and drive options, DOS uses the values of the previous DOS 
command. If you do not know the default, specify exactly what you 
want. 


When you omit the volume argument altogether, specify volume 
number 0, or type (Y) without a number, DOS uses the default volume 
number, 254. If you specify a volume number, DOS assigns that 
volume number to the disk. 


Use INIT to assign a particular volume INIT is the only command that assigns a volume number. When the 
number. volume option is used with other DOS commands, the number 
specified must match the number assigned by INIT. 


The step-by-step procedure for initializing a disk is described in 
Chapter 1. 


Hint: If you have several blank disks, it would be a good idea to initialize a 
few of them now. Then the initialized disks will be ready when you need 
them. 


Ss Determining Slot and Drive Numbers: 
The SLOT# Program 


The SLOT# program reports the slot and drive numbers that you are 
currently using, that is, the current default values. 


Some programs, such as the copy programs, ask you for slot and 
drive numbers. With some commands, such as the INIT command, 
you may damage the contents of a disk unless you know which slot 
and drive DOS will use by default. 

To confirm the current slot number and the current drive number, you 
can run the SLOT# program on your SYSTEM MASTER disk. With 
the SYSTEM MASTER in drive 1, type: 
(RYUJN)GPACELS\L Olt) GHIFTY#) 


The program’s report will look something like this: 


CURRENT SLOT IS 6 AND DRIVE IS 1 
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AAA Chapter 3 Summary 


Commands 


CATALOG [,Sn] [,Dn] displays a listing of all the files on your 
disk. In addition to the filename, the 
catalog lists the size, type of file, and 
whether the file is locked. 


INIT fn [,Sn] [,Dn][,Vn] prepares a disk to receive information. The 
INIT command places DOS and a greeting 


program on the disk. 

Programs 

COPYA copies an entire disk when you are running 
Applesoft BASIC. It is not necessary to 
initialize the duplicate disk. 

COPY copies an entire disk when you are running 
Integer BASIC. Itis not necessary to 
initialize the duplicate disk. 

SLOT# reports the current default values for slot 


and drive numbers. 
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Using Files 


An explanation of the syntax notation in 
this manual can be found in Chapter 2, 
“DOS Commands.” 


Chapter 4 


Using Files 


This chapter describes the DOS commands that allow you to keep 
track of and manipulate the files on your disks. You can use these 
commands to change the name of a file; to create more room on a 
disk; to protect some information from being accidentally destroyed; 
and to verify that a file on the disk can be read. 


The FILEM program, discussed at the end of the chapter, allows you 
to perform operations on several or all the files ona disk at the same 
time. 


This chapter will introduce each command and then use an example 
to illustrate how the command works. When you are trying the 
examples, it's a good idea to use a copy of the SAMPLE PROGRAMS 
disk rather than the original. That way, if someone else wants to learn 
about DOS after you're finished, the sample programs will be in their 
original state. 


The RENAME Command 


The RENAME command allows you to change the name of any file on 
adisk. You can use it to change the name of a BASIC file, text file, or 
binary file. 


The command has this syntax: 

RENAME fn1,fn2 [,Sn] [,Dn] [, Vn] 

The RENAME command changes the name of a file from the name 
indicated by fn1 to the name indicated by fn2. The filename 
represented by fn1 is the name of an existing file, which must be 
unlocked. The new name, fn2, should be unique for the disk. 

The slot number, drive number, and volume number arguments are 


optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


The RENAME Command 


The UNLOCK command is explained 
later in this chapter. 


If the file you specified as fn1 does not exist, you'll getthe FILE 
NOT FOUND error message. If the file is locked, you'll get the 
FILE LOCKED error message. 


Incidentally, you can also change the name of a file by loading the file 
into memory and then saving a copy to the disk with anew name. 


Warning 


When RENAME is executed, DOS does not check to see if the second 
filename (fn2) already exists on the disk. DOS will carry out the RENAME 
command and leave you with two files with the same name. 


When there are duplicate filenames on a disk, DOS only recognizes 
the first file, which makes it hard to access the second file. For 
example, if your disk’s catalog looked like this: 


HELLG 
LETTERS 
SORT 
PROGRAM, 1 


and you issued the command 
RENAME PROGRAM, 1 +SORT 
Your catalog would then look like this: 
HELLO 

LETTERS 

SORT 

SORT 


You would not be able to use the second SORT until you renamed the 
first one. 


To correct the situation, rename the first file named SORT. Be sure 
the new name is unique to the disk. Then you can use the second file 
named SORT. 


To prevent this from happening, you should always check the catalog 
before changing the name of a file. 
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Example 


1. Find the SAMPLE PROGRAMS disk and putitinto drive 1. Check 
the catalog by typing 
COLDOOOASLADO 


Press (RETURN). As well as giving you a listing ofthe files on the 
SAMPLE PROGRAMS disk, this command sets the defaults to 
slot 6, drive 1. The catalog includes the files HELLO, ANIMALS, 
BRICK OUT, and PHONE LIST. 


Press the bar to continue the catalog. 


2. To change the name of PHONE LIST (fn1) to DIRECTORY (fn2), 
type 
CAEN e eran role racista) 
When you press (RETURN), DOS changes the file's name. 


3. Now issue the CATALOG command again to see the result of your 
order. Remember to press bar to see the rest of the catalog. 


4. Now change the name back to give yourself a little more practice 
with the command. Type 


080006300060 4000800008E> 
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A The LOCK Command 


Write-protecting a diskis explained in 
Chapter 1, "About Disks and Disk 


The LOCK command locks a file: it protects the file from being 
accidentally changed, deleted, or renamed. However, a locked file 
can be loaded and run. 


Trying to change, delete, or rename a locked file resultsina FILE 
LOCKED error message. To change a locked file, you must first 
unlock it with the UNLOCK command. 


When you look at the catalog of a disk, the locked files are marked by 
asterisks to the left of their file types. 


By the Way: The LOCK command only works on one file at a time. To 
protect a whole disk, simply cover its write-enable notch with a silver 
write-protect tab. 


The command has this syntax: 
LOCK fn [,Sn] [,Dn] [,Vn] 
The filename, fn, indicates the file to be locked. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


Example 
1. With the SAMPLE PROGRAMS disk in drive 1, display the catalog 
of its files by issuing a CATALOG command. 


Notice that the file LOCK.ME.1 does not have an asterisk, 
indicating that it is not locked. 


2. Lock the file LOCK.ME.1 by typing 
(oo KIGPACEL Olek. (MEL) 


3. Use the CATALOG command again to check that LOCK.ME.1 is 
now protected from accidental change. It should have an asterisk 
at the beginning of its catalog entry. 


Using Files 


AA The UNLOCK Command 


The UNLOCK command unlocks a file; that is, it removes protection 
from a file so that you can delete, rename, or change the file. The 
UNLOCK command works on one file at a time. 


The command has this syntax: 
UNLOCK fn [,Sn] [,Dn] [, Vn] 
The filename, fn, indicates the file to be unlocked. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


Example 
1. With the SAMPLE PROGRAMS disk in drive 1, display the catalog 


of its files by issuing a CATALOG command. 


Notice that the files LOCKED.UP.1 and LOCKED.UP.2 have 
asterisks indicating that they are locked. 


2. Unlock the file LOCKED.UP.1 by typing 
Ono nc) o ura 


3. Use the CATALOG command again to verify that the file is now 
unlocked. The file should not have an asterisk in front of its file 


type. 
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A The DELETE Command 


The DELETE command lets you remove a file from a disk. It is used 
to get rid of unwanted versions of files and to make space on a disk 
for new files. 


The command has this syntax: 
DELETE fn [,Sn] [,Dn] [,Vn] 


The file indicated by fn must be unlocked. (That is, you do not see an 
asterisk in front of the catalog entry for the file). Ifthe file does not 
exist, you'llgeta FILE NOT FOUND message when you try 
the command. If the file is locked, you'llgeta FILE LOCKED 
message. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


Example 

1. With the SAMPLE PROGRAMS disk in drive 1, display the catalog 
of its files by issuing a CATALOG command. 
Included in the catalog is the file DELETE.ME.1. 

2. Delete the file DELETE.ME.1 by typing 
OGSGRGez30G0G0 680680 


3. Use the CATALOG command again to check that DELETE.ME. 1 
is no longer listed and therefore no longer on the disk. 
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A The VERIFY Command 


The VERIFY command lets you make sure a file was written on the 
disk correctly and that DOS can still readit. Ifthe file can be verified, 
it’s safe to assume that the information on the disk has been stored 
correctly and can be retrieved whenever you want. 


If DOS can read the file successfully, it displays the prompt. If DOS 
finds that it cannot read the file (the file is damaged or written 
incorrectly), it displays the message I/0 ERROR. 


To verify a file, DOS simply reads the file from the disk into an area in 
memory thatis not currently in use. This does not affect a program 
that might be in memory already. 


The command has this syntax: 
VERIFY fn [,Sn] [,Dn] [, Vn] 


Any type of file may be verified. If the file does not exist, you'll get a 
FILE NOT FOUND message. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don’t want to 
use the default. These arguments are described in Chapter 2. 


Example 

1. With the SAMPLE PROGRAMS disk in drive 1, display the catalog 
of its files by issuing a CATALOG command. 
Included in the catalog is the file VERIFY.ME. 

2. Verify the file by typing 


Remember, when DOS can read the file, no special message is 
displayed. 
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FILEM lets you manage individual files as 
well as whole volumes. 


A menuis alist of choices. 


Figure 4-1. FILEM's Menu. You see 
FID VERSION M because FILEM 
runs the binary program FID. 


The FILEM Program 


So far, this chapter has discussed the DOS commands that rename, 
lock, unlock, delete, and verify files one at a time. The FILEM 
program on your SYSTEM MASTER disk offers you these same 
functions and a few more. It allows you to perform operations on an 
individual file or a set of files on a disk at the same time. 


To use FILEM, insert the SYSTEM MASTER disk in drive 1. Then 
issue a RUN command. Type 


00200060800 


After the message EXECUTING FID appears briefly, you'll 
see FILEM's menu on the display (Figure 4-1). 


To choose a command, type the number in the angle brackets (< >) 
next to the command. Then press (RETURN). Type only the number, not 
the angle brackets. 
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Awildcard is a character that stands for 
any character sequence in a filename. 


Specifying Slot and Drive Numbers 


The first time FILEM executes options 1, 2, 3, 4, 5, 6, or 8 it will ask for 
slot and drive numbers. You'llsee SOURCE SLOT? then 
DRIVE? Source refers to the disk from which you want to read 
information. 


Switching from one option (between 1, 2, 3, 4, 5, 6, and 8) to another 
also will cause prompting for slot and drive numbers. If you want to 
repeat the option, the program will use the numbers you've already 
specified. 


If you want to repeat the option, but you want to change the defaults, 
you must execute option 7 first. 


By the Way: If you give numbers for non-existent slots or drives, FILEM 
beeps and displays the message INVALID SLOT or INVALID 
DRIVE. Simply type the correct number. 


Specifying Filenames With the Wildcard 
Character 


Some of FILEM's commands ask for a filename. You may spell out 
the filename fully, letter by letter. Or you may use only a few of the 
letters in the name and a special character called a wildcard. This 
special character stands for any sequence of characters in a 
corresponding position in filenames. The wildcard character is the 
equal sign (=). 


For example, A=S can represent any filename beginning with A and 
ending with S. A= S can refer to all these filenames: 


e AS The = stands for no characters. 

e ACTS The = stands for the characters 
CT. 

e ACCESS The = stands for the characters 
CCES. 

e ALLSWELL THAT ENDS The = stands for LLS WELL 
THAT END. 


When you use the wildcard character, FILEM asks if you want to 
approve each file before FILEM processesit. ltasks DO YOU 
WANT PROMPTING? To have FILEM quietly process all the files 
that match your filename specification, type (N) for “no” prompting and 
press (RETURN), 


The FILEM Program ll 


Figure 4-2. Using the Wildcard to 
Represent Parts of Filenames 


When you want to confirm each file in a command, type (Y) and press 
(RETURN). FILEM then displays each filename before doing anything 
to the file. To have FILEM process that file, type (Y) and press (RETUAN). 
To have FILEM skip over that file, type (N) and press (RETURN), By 
displaying the message CANCELLED, FILEM tells you it skipped 
that file. 


Helpful Hint: When you've processed all the files on a disk that you want 
to process, type (a) and press to return to the menu and cancel the 
command. 


FIRED 
FRIENDLY 


-D O42 CROUTON ; 
Bonm o ooo 


Figure 4-2 shows some examples of using the wildcard character to 
work with groups of files. 


e FR = ED represents all the files with names that begin with FR and 
end with ED. It does not represent the file named FIRED because 
an / is the second character, not R, or the file named FRIENDLY 
because the filename ends with LY, not ED. 


e =N= represents all files with names that contain an N. NICE has 
one atthe beginning; ENERGY and FRIENDLY have one in the 
middle; and CROUTON has one at the end. You'll also get the file 
named N. 


e = represents all the files on the disk. If you use the wildcard by 
itself with FILEM, all the files on the disk will be used in the option. 
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Using FILEM Options 


Six of the eight options in the FILEM program correspond to DOS 
commands that you use to process individual files. However, using 
the FILEM wildcard lets you process several files with one command. 


When FILEM finishes processing an option, you'llsee PRESS 
ANY KEY TO CONTINUE. 


Press Almost Any Key: PRESS ANY KEY TO CONTINUE 
means type any key except (RESET), (SHIFT), CONTROL), (©), (8), or (CAPS LOCK), 
We suggest that you use the bar. 


<1> COPY FILES 


This option copies one or more files from one disk to another. 


Note: Unlike the COPY and COPYA programs, FILEM does not initialize 
the duplicate, or destination, disk. 


If you plan to use FILEM to make copies, initialize some blank disks 
before running the program. The INIT command is covered in Chapter 3. 


Before FILEM executes option 1, it asks for the slot and drive 
numbers of the source disk. You'llsee SOURCE SLOT? ,then 
DRIVE? Source refers to the disk from which you want to read 
information. 


It also asks for the slot and drive numbers of the destination disk. 
You'llsee DESTINATION SLOT?,then DRIVE? 
Destination refers to the disk that will receive the information. 


@ When you have one disk drive connected to your computer, the 
slot and drive numbers for the source and destination disks are the 
same. FILEM will tell you when to insert the source and the 
destination disks into the disk drive. 


e When you are using two drives, the slot number is the same for 
both disks, but the drive numbers are different. FILEM says 
simply: INSERT DISKS. 


After FILEM has the information on slot and drive numbers, you'll see 
FILENAME? prompting you for the name of the file to copy. 
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This example takes you through the process of using FILEM to copy 
with two drives. You should have the SYSTEM MASTER in drive 1. If 
you do not have FILEM's menu on your display, start the program with 


a RUN command. Type 
(RXUN) GEPacE (CF U EML, (oG 


What You Do 


1. To select option 1 from the 
menu, type 


© 

and press (RETUAN), 
2. Type 

(6) 


for slot 6 and press (RETURN). If your 


disk controller card is installed in 
a different slot, type that number. 


3. Type 
0 


for drive 1 and press (RETURN), 


4. Type 
(s) 


for slot 6 and press (RETURN), 

If your disk controller card is 
installed in a different slot, type 
that number. 
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What You Get 


You'llsee COPY FILES on 
your display and a prompt from 
FILEM asking for the slot number 
ofthe source disk, SOURCE 
SLOT? 


You'llsee DRIVE? onyour 
display. The program is asking 
which disk drive holds the 
original disk. 


You'llsee DESTINATION 
SLOT? on your display. Now 
the program wants information 
about the destination disk. 


You'llsee DRIVE? onyour 
display. The program is asking 
which disk drive holds the 
destination disk. Remember: the 
destination disk must already be 
initialized. 


5. Type FILEM should be displaying all 
the slot and drive numbers that it 


(2) will use. Up to this point, it has 
not copied anything from the 

for drive 2 and press (RETURN). disk. FILEM has simply found out 

If you are using only one disk where to get information and 

drive, type L) instead. where to put it. 


FILENAME? will prompt you 
for the name of the file or files to 
copy. 


6. This is the point at which you 
can use a wildcard to represent 
part of a filename. You could 
type MASTER, ME), 

or ifyou wanted to copy 
the file MASTER. 


But =M= will copy the five files 
on the MASTER disk that have 
an M in their filename, which you 
don't want to do. Although if you 
know that using a wildcard will 
only copy the file or files that you 
want, it can be a convenient 
shortcut, such as M=R. And 
then you can always use the 
prompting option to OK each file 
for the command individually. 


Whenever you use a wildcard, 
the program willask DO YOU 
WANT PROMPTING? Ifyou 
do, type (¥) for yes, and you will be 
allowed to decide whether each 
file indicated by the wildcard 
should be copied or not. If you 
want the file copied, type (Y) after 
the name of the file. If you want to 
skip the file, type (N). 
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When you are only copying one 
file, however, itis safer to type 
the whole name. So type 


(mias fr E) 


and press (RETUAN). 


7. Be sure the source disk is in 
drive 1 and the initialized disk is 
in drive 2. Then press the 
bar when you are ready to start 


copying. 


8. Press the bar. 


The message INSERT 
DISK(S) PRESS <ESC+ 
TO RETURN TO MAIN 
MENU OR ANY OTHER 
KEY TO BEGIN tells you 
that the program is ready to 
begin. 


FILEM finds the file you asked for 
and begins the copy operation; it 
displays FILE MASTER. If 
the same filename already exists 
on the disk in drive 2, you'll hear 
a beep, and FILEM will display 
more instructions. When copying 
isfinished, you'llsee DONE. 


Finally, you'llsee PRESS 
ANY KEY TO CONTINUE. 


FILEM's menu of options 
returns. 


Copying Locked Files: The FILEM copy command will copy locked files. 
The copied files will also be locked on the destination disk. 


<2> CATALOG 


This option displays a disk's catalog. It is handy to use when you're 
running FILEM and need to check a disk's contents: you don't have to 
exit from the FILEM program, issue the DOS CATALOG command, 
and then return to FILEM with a RUN command. 


For example, if you want to look at the catalog of the SAMPLE 
PROGRAMS disk, remove the SYSTEM MASTER from drive 1 and 
insert the SAMPLE PROGRAMS disk. Select option 2, CATALOG. 
FILEM will ask for slot and drive numbers. Be sure to indicate drive 1. 


FILEM will display a catalog of the SAMPLE PROGRAMS disk. To 
return to the options menu, press the bar. 


<3> SPACE ON DISK 


When you select option 3, FILEM reports how many sectors are used 
and how many are unused on your disk. 
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Try the option now. With the SAMPLE PROGRAMS disk still in drive 
1, select option 3. You'll see something like this on your display: 


SPACE ON DISK 


0117 SECTORS FREE 
0443 SECTORS USED 


To return to the menu, press the bar. 


<4> UNLOCK FILES 
This option lets you unlock a file. 


This example shows how to use FILEM to unlock a file on a disk. 
Be sure the SAMPLE PROGRAMS disk is still in drive 1. 


What You Do 


1. Select option 4 from the menu 
and press (RETURN). 


2. Type the appropriate numbers 
for the disk whose files you want 
to unlock. 


3. Type 
and press RETURN). 


You can use a wildcard in 
response tothe FILENAME? 
prompt. If you do, the program 
willask DO YOU WANT 
PROMPTING? Ifyou do, type 
for “yes;” the name of each 
file indicated by the wildcard will 
appear in succession. When 
each filename is displayed, you 
must tell FILEM whether to 
unlock the file or not. 
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What You Get 


You'llsee UNLOCK FILES 
on your display. FILEM asks for 
the slot and drive numbers of the 
source disk if it has not already 
done so. 


FILENAME? isdisplayed. 


Type (*) if you want the named 
file unlocked; the disk whirs 
briefly, DONE appears, and 
the program proceeds to the 
next file indicated by the 
wildcard. Type “N” if you do not 
want the named file unlocked; 
you'llsee CANCELLED 
underneath the filename, and the 
prompting will continue. 


4. Be sure the disk whose files 
you want to unlock is in the 
appropriate disk drive. Then 
press the bar to begin. 


5. To return the FILEM menu, 
press the bar. 


<5> LOCK FILES 


You'llsee INSERT 
DISK(S). PRESS 
<ESC> TO RETURN TO 
MAIN MENU OR ANY 
OTHER KEY TO BEGIN. 


You'llsee FILE HELLO 
andthen DONE when FILEM 
has unlocked the file named 
HELLO. 


Finally, you'llsee PRESS 
ANY KEY TO CONTINUE. 


This option locks a file so that it cannot be changed, deleted, or 


renamed. 


The following is an example of how to use FILEM to lock all the files 
on adisk. Be sure the SAMPLE PROGRAMS disk is still in drive 1. 


What You Do 


1. Select option 5 from the menu 
by typing (5) and pressing (RETURN). 


2. Type the appropriate numbers 
for the disk whose files you want 
to lock. 
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What You Get 


You'llsee LOCK FILES on 
your display. FILEM asks for the 
slot and drive numbers of the 
source disk if it has not already 
done so. 


FILENAME? is displayed. 


3. Type 
O 


and press (RETURN). When the 
wildcard is used by itself, it 
stands for all the files on the 
specified disk. 


4. Type 
N) 


for “no” prompting since you 
know you want to lock all the 
files. Press (RETURN). 


Ifyou wanted to confirm each file 
that should be locked, you would 
type (Y) and then respond with 


either (Y) or (N) as each file's name 
is displayed. 


5. Press the bar to begin. 


5. Press the bar. 
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TheDO YOU WANT 
PROMPT ING? message is 
displayed. 


You'llsee INSERT 
DISK(5) PRESS <ESC> 
TO RETURN TO MAIN 
MENU OR ANY OTHER 
KEY TO BEGIN. 


FILEM will go ahead and 
process all the files that match 
your filename specification. 
You'll see FILE followed by a 
filename for each file on the disk. 
When FILEM has finished 
locking all the files, you'll see 
DONE. 


Finally, you'llsee PRESS 
ANY KEY TO CONTINUE. 


You'll return to FILEM's menu. 


<6> DELETE FILES 


This option deletes a file or set of files. FILEM deletes the file from the 
disk and from the catalog. Once you have deleted a file, it is gone for 
good. 


When you select option 6, you'llsee DELETE FILES onyour 
display, and you will be asked for the slot and drive numbers of the 
source disk if FILEM has not already done so. Check that the correct 
disk is in the disk drive. 


Whenyousee FILENAME?, type the name of the file that you 
want to delete and press (RETURN). When the file has been deleted, 
FILEM displays DONE and PRESS ANY KEY TO 
CONTINUE. Toreturn to the menu, press the bar. 


<7> RESET SLOT & DRIVE 


This option cancels whatever numbers you had previously set for slot 
and disk drive. The next time you ask for an option that requires slot 
and drive numbers, FILEM will request them. When you wish to use 
FILEM's catalog command on two different drives in succession, use 
this command. 


When you see FILEM's menu, select option 7. FILEM displays 
RESET SLOT 8 DRIVE, DONE, andthen PRESS ANY 
KEY TO CONTINUE. Toreturn to the menu, press the (SPACE) bar. 


<8> VERIFY FILES 


When you select option 8, FILEM verifies a file. Thatis, FILEM tries 
to read the file from the disk into memory. FILEM is able to verify all 
types of files. This command is the same as the VERIFY command of 
DOS. 


When you select option 8, you'llsee VERIFY FILES onyour 
display, and you will be asked for the slot and drive numbers of the 
source disk if FILEM has not already done so. Check that the correct 
disk is in the disk drive. 


When yousee FILENAME?, type the name of the file that you 
want to verify and press (RETURN), When the file has been verified, 
FILEMdisplays DONE and PRESS ANY KEY TO 
CONTINUE. Toreturn to the menu, press the bar. 


If the file isn't found, you'llgeta FILE NOT FOUND message. 
If the file can't be verified, you'llgetthe 1/0 ERROR message. 
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<9> QUIT 


When you select option 9, FILEM returns you to BASIC. You will see 
the same prompt character on the display as you did before you 
executed the FILEM program. 


Incidentally: FILEMis an Applesoft BASIC program that runs FID, a 
binary program on the SYSTEM MASTER disk. You can run FID directly if 
you choose. Issue the binary command to run a program: BRUN FID. 


FILEM’s Messages 


Here are some of the messages you might get while using the FILEM 
program: 


e When you are using the copy option and the destination disk 
already contains a file with the name you used, FILEM displays the 
message: 


FILE [filename] 

ALREADY EXISTS, 

TYPE IN NEW FILENAME FOR THE COPY OR 
¿RETURN> TO REPLACE EXISTING FILE OR 
<CONTROL-C?<RETURN?= TO CANCEL COPY 


If you press and the destination file is unlocked, FILEM 
writes the contents of the source file over the contents of the 
destination file. If you enter a new filename, the source file is 
stored under that new name. 


e When you are using the copy option and the destination file is 
locked, you will see: 


FILE LOCKED 
DO YOU WISH TO REPLACE IT ANYWAY? 


If you type (Y) for “yes” and press (RETURN), FILEM writes over the 
locked destination file with the contents of the source file. If you 
type (N) for “no” and press the (RETURN), FILEM gives you a chance 
to assign another name. The display shows the message: 


TYPE IN NEW FILENAME FOR THE COPY OR 
<<RETURN? TO REPLACE EXISTING FILE OR 
<CONTROL-C?<2RETURN? TO CANCEL COPY 
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Ifyou press (RETURN), FILEM writes over the locked destination file 
with the contents of the source file. However, if you press (CONTROL)-(C) 
and (RETURN), FILEM does not copy the file. CANCELLED is 
displayed and you return to the menu if you were copying only one 
file. If you were using the wildcard to copy more than one file, only 
the command for the file in question is canceled. 


e When FILEM cannot find a source file, it displays the message: 
NO FILES SELECTED 


Check the catalog and then try the command again. 


e |f you give an improper slot or drive number, or an invalid filename, 
you'llsee INVALID SLOT, INVALID DRIVE, or 
INVALID FILENAME. 
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A Chapter 4 Summary 


Commands 


RENAME fn1,fn2 [,Sn] [,Dn] [,Vn] 


LOCK fn [,Sn] [,Dn] [,Vn] 


UNLOCK fn [,Sn] [,Dn] [,Vn] 


DELETE fn [,Sn] [,Dn] [, Vn] 


VERIFY fn [,Sn] [,Dn] [, Vn] 


Program 


FILEM 


Chapter 4 Summary 


changes the name of a file from 
the name fn1 to fn2. 


protects a file from being 
accidentally destroyed. A locked 
file cannot be renamed, deleted, 
or changed until it has been 
unlocked. 


removes protection from a 
locked file, making it possible to 
rename, delete, and change the 
file. 


removes a file from a disk. The 
file fn must be unlocked. 


checks that a file is properly 
stored on the disk. 


combines several useful tasks 
with DOS commands that handle 
files in a program that can work 
with groups of files. FILEM uses 
a wildcard and can operate on 
locked files. 
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Chapter 5 


Using Programs Already 
on Disks 


This chapter describes the DOS commands that let you use the 
BASIC programs on your disks. If all you want to do is run programs 
that are already on disks, pay special attention to the RUN command; 
it moves any BASIC program from a disk file into memory and starts it 
running. 

Figure 5-1. Using DOS Commands With 

Baste Progr The commands discussed in this chapter let you 


e bring a program into memory and start it running (the RUN 


command) 

e bring a program into memory without running it (the LOAD 
command) 

e store a program or information that is currently in memory on a 


disk (the SAVE command) 
communicate with devices connected to your computer 


These commands are most relevant 
when you are running or modifying 
programs that already exist. 


RUN copies a program from the disk into 
memory and executes it. 


= LHH 


E 


LOAD copies a program from a disk into 
memory. 


SAVE copies a program in memory to a 
disk. 
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You use the RUN command to start a 
program running. 


A peripherai card is a removable 
printed-circuit board that plugs into an 
expansion slot and expands or modifies 
the computer's capabilities. 


An explanation of the syntax notation in 
this manual can be found in Chapter 2, 
“DOS Commands.” 


The RUN Command 


The RUN command executes an Applesoft or Integer BASIC 
program that is stored on a disk. The command loads the program for 
you. Starting a program up this way is called running the program. 


RUN combines several tasks into one command. When DOS sees 
the RUN command, first it finds the named program. Then, before 
bringing the program into memory, DOS checks the program's file 
type. If the language is not being used, DOS switches to the 
appropriate one, if possible. 


When the file’s type is A and Applesoft BASIC is not active, DOS 
switches to Applesoft. When the file's type is | and Integer BASIC is 
not active, DOS switches to Integer. 


Note: DOS is unable to switch automatically if your Apple computer has 
only one language available. Apple ll and Apple II Plus computers require 
alanguage card or some other peripheral card to use both Applesoft and 
Integer BASIC programs. 


Once DOS has switched to the program's language, DOS brings a 
copy of the program into memory and starts it running. Since the 
RUN command automatically loads a program into memory, it is not 
necessary to use the LOAD command before you run a program (the 
LOAD command is explained in the next section). 


By the Way: The RUN command erases main memory before it puts a 
copy of the program there. If you have something in memory that you don't 
want to lose, you must store it on a disk with the SAVE command before 
you issue a RUN command. 


The command has this syntax: 
RUN fn [,Sn] [,Dn] [,Vn] 


The filename, fn, indicates the program that DOS is to run. Its file type 
must be either A or I. If the program is not on the disk, you'll see 
FILE NOT FOUND. Ifthe file type is not A or l, you'llsee FILE 
TYPE MISMATCH. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


By the Way: Once your program is in memory, you can run it again by 
issuing the RUN command without a filename. Without a filename, RUN 
is a BASIC command. 
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Example 


The following example will show how the RUN command works with 
Integer BASIC and Applesoft BASIC programs. 


If You Have Only One BASIC Language: If you try to run a program 
whose language you don't have in yqur computer, you'll see 
LANGUAGE NOT AVAILABLE. Try the RUN command on the 
program that has the file type for your BASIC. 


1. Insertthe SAMPLE PROGRAMS disk into drive 1. Use the 
CATALOG command to look at the disk's contents and to set the 
slot and drive number. Type 
COVOGOCEZ30080G6 
You'll see the programs APPLEVISION and COLOR TEST listed 
in the catalog. 

2. Now try running the Integer BASIC program. Type 
DO Vez 30000005000) 


and press (RETURN), You'll see the most amazing display. When you 
want to stop the show, press (Esc). You'll see Integer BASIC's 
prompt, >. 


3. The Applesoft program is a spectacular demonstration for color 
screens. But even if you don't have color, you'll be able to watch a 
fascinating two-tone display. Type 


(Alu) Grace coo arce TEST) 


When you've had enough, press to stop the program and to 
return to the menu. Press (5) to exit from the COLOR TEST 
program. You'll see Applesoft's prompt, J. 


Language Switching: If your Apple computer has both Applesoft and 
Integer BASIC available, DOS changed languages automatically; you 
didn't have to issue any special command. 
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E The LOAD Command 


The LOAD command puts a copy of a The LOAD command transfers a program from a disk into memory. 

program on a disk into memory. Before bringing the program into memory, DOS checks the program's 
file type and tries to switch to the appropriate BASIC. When you use 
the LOAD command to bring a copy of the contents of a file into 
memory, the file on the disk remains unchanged. 


It is not necessary to load a program before you use the RUN 
command; RUN automatically loads the program into memory. 


By the Way: The LOAD command erases main memory before it puts a 
copy of the program there. If you have something in memory that you don't 
want to lose, you must store it on a disk with the SAVE command before 
you issue a LOAD command. 


The command has this syntax: 
LOAD fn [,Sn] [,Dn] [, Vn] 


The filename, fn, indicates the program that DOS is to load. Its file 
type must be either A or I. If the program is not on the disk, you'll see 
FILE NOT FOUND. Ifthe file type is not A orl, you'llsee FILE 
TYPE MISMATCH. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


Example 
1. With the SAMPLE PROGRAMS disk in drive 1, bring a copy of the 
GET TEXT program into memory by typing 


ob) Ercels E)(T)\ Grace (TET) 
You'll hear the disk drive working. Then you'll see BASIC's prompt 
again. 

LIST is a BASIC command. 2. To look at the program, use the LIST command. Type 


You'll be looking at the BASIC statements that make GET TEXT 
work. If you're curious about the programming involved, this 
program is discussed in the DOS Programmer's Manual. 


When you load a program, DOS transfers a copy from the disk to the 
computer's memory. The original version remains unchanged on the disk. 
You can use the CATALOG command to see that a file is still on the disk 
after you load a copy of its contents into memory. 
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A The SAVE Command / 
The SAVE command puts a copy of the The SAVE command transfers the BASIC program that is currently in 
program in memory onto a disk. memory to a file on a disk. 


DOS keeps track of the language you are in and writes the program 
to the disk with the proper file type. When you are using Applesoft 
BASIC, DOS saves the program with file type A. When you are using 
Integer BASIC, DOS saves the program with file type I. 


DOS also determines the length of the program and where to put it on 


the disk. 
The LOCK and UNLOCK commands are Once you have saved a program, you can use the LOCK command to 
discussed in Chapter 4. protect it from accidental erasure. The UNLOCK command removes that 
protection. 


You can use the SAVE command to copy files and to make backup 
copies of a program. To do this, use the LOAD command to bring a 
copy of the file’s contents into memory, then use the SAVE command 
to save the program to a different disk or on the same disk with a 
different name. 


The command has this syntax: 
SAVE fn [,Sn] [,Dn] [, Vn] 


The fn argument specifies the filename for the program. If a disk file 
by that name already exists, DOS will copy the program in memory 
over the program on the disk if the file is unlocked and it is the same 
type (A or |). 


You'llsee 1/0 ERROR when you use the SAVE command if the 
specified disk is bad, if the disk is not initialized, if there is no disk in 
the disk drive, or if the drive door is open. Put an initialized disk in the 
disk drive, close the door properly, and issue the SAVE command 
again. 


The slot number, drive number, and volume number arguments are 
optional. You only need to specify a number when you don't want to 
use the default. These arguments are described in Chapter 2. 


A Warning 


If you save a program in memory to a file on a disk that already has a file 
with the same name and file type, the contents of the original disk file are 
lost. DOS does not display any warning. 


The SAVE Command (405 | 


Example 
1. Put an initialized disk into disk drive 1. Be sure that it is not write- 
protected—that the write-enable notch is uncovered. 
NEW is a BASIC command that erases 2. Issue a NEW command to clear memory for a new program. Type 
memory. 
MEW 
and press (RETURN). 
3. Now, type a short program, such as: 
10 PRINT "A SHORT PROGRAM" 
20 END 


Even if you aren't too familiar with writing programs, you might 
guess that this program does only one thing: itprints A SHORT 
PROGRAM onthe display. 


Without a filename, RUNis a BASIC 4. To test your program, use the BASIC command RUN. Type 
command. DOR 
and press (RETURN). 

5. Then, to save the program on your disk, use the SAVE command 
with a descriptive filename. For instance, type 
60086£E30066€E300060 
and press (RETURN). 

The disk drive whirs as the SAVE command puts your program on 
the disk and names it ONE LINER. 


Check It Out: After you use the SAVE command, you can see thata 
program has found its new home on the disk by using the CATALOG 
command. Notice that a copy of a program remains in memory (it will stay 
there until you issue a NEW command or turn off the computer). You can 
use the RUN or LIST commands to check that the program is still in 
memory. 
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A Talking to Other Devices 


The commands PR# and IN# enable your Apple computer to 
communicate with devices like printers that are connected through 


An expansion slot is a connector inside expansion slots. 
the computer in which a peripheral card 
can be installed. A peripheral card is a 


removable printed-circuit board that Your Apple computer usually sends characters tothe screen and 
plugs into one of the expansion slots. Itis reads characters from the keyboard. The PR# and IN# commands 
used to connect a peripheral device. allow your computer to talk to additional devices, called peripheral 
A peripheral device is used in devices. Such communication is referred to as I/O, the input and the 
conjunction with the computer. Itis output of information. 


usually connected with a peripheral card 


SARE an oder dl open In the PR# and IN# commands, you must type the # character. 


peripheral devices. 


A Warning 


f ; If you do not have a controller card in the slot that you have specified with 
1/O refers to the transfer of information the PR# or IN# commands, random events may occur. For example, if 
into and out of a computer. your controller card is in slot 7 and you issue á PR#6 command, the disk 
A \ : i will boot on some systems and noton others. You won't see an error 
he nema ii tee message, but DOS may look like it's disconnected. You have to restart 
or disk drive, to the computer and DOS if it doesn't restart itself. See the section at the end of this chapter, 
controls the operation of the device. “Ways to Restart DOS. 


Figure 5-2. The PR# and IN# 
Commands. PR#0 should never be used 
when an 80-column text card is active. 
See Warning in next section. 


PR#1 sends 
informationtothe {f 
printer if your printer "S 


card is insiot1. == > 


IN#4gets “> 
information from “SS 

a telephone network “N 
if your modem card 

isin slot 4 


eee | 
i 
fe, 


Talking to Other Devices 


The PR# command directs information 
to any device. 


The PR# Command 


The PR# command tells your computer where to send information; 
that is, it specifies a device connected through one of the computer's 
slots. The PR# command will send all information—including 
prompts, error messages, commands, program listings, and 
catalogs—to the device specified. 


A Bit of Speculation: Back in the dark ages of computers, a printer was 
the one and only output device. The name of the PR# command probably 
is short for “printer.” In addition, printers used to be assigned numbers, 
which may account for the number symbol (#) in this command. 


The command takes this form: 
PR#n 


The number, n, is the slot that connects the device to which you want 
to send information. The number can be between 0 and 7. 


When you want to send information to the display again, use PR#0, 
unless you are using an 80-column text card. This command works 
on the Apple lle computer even though the lle does not have a slot 0. 


Warning 

When your Apple Ile computer is operating the 80-column text card, 
using the PR#0 command is not recommended. Use PR#3 (instead of 
PR#0) to deactivate the printer and reconnect the 80-column text card. 
Use (Ese) (controL)-(a) to deactivate both the 80-column text card and 
the printer. 


If you have a printer, you can send a disk's catalog to the printer. 
When your printer is connected to a printer controller card installed in 
slot 1, type 


PA GHEDAM GERM) 
CANALE 


When you are through printing and want to send information to the 
display again, type 


(P\R)GHET)-(#)0) 
or 


(PR) GHIFT)-(#)3) if your 80-column text card is active. 
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Starting Up a Disk Using the PR# Command: Even though the PR# 
command is used primarily to direct outgoing information, you can also 
use PRA to start disk drives. Using the command this way is easier on the 
equipment than turning the power off and then on again. 


Note: If you have an Apple II with the old Monitor ROM, you must 
start DOS with (5) and be in BASIC before you can use 
the PR# command to start disks. 


Example 


1. Putthe SAMPLE PROGRAMS disk in drive 1, close the door, and 
type 
OOETIOO 


and press (RETURN). If your disk controller card is connected via 
another slot, use that number. Drive 1 will whir as DOS starts up 
the disk drive. 


2. Ifyou have a printer connected via slot 1, try printing a program 
listing. First read HELLO into memory by typing 


BOOK e2-30G000 
3. Then, to direct the computer's output to the printer, type 


and press (RETURN). If your printer controller card is in another slot, 
specify the number of that slot. 


4. Now, to print a listing of HELLO, type 


0000 
and press (RETUAN), Your printer will print a listing of the HELLO 
program. 


5. Try issuing other commands. Everything that is normally printed 
on the display goes to the printer, including prompts and error 
messages. 


6. To send information back to the display screen, use the PR# 
command with slot number 0. 
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The IN# command talls your computer 
where to get information 


The IN# Command 


The IN# command tells your computer where to get information; that 
is, it specifies a device connected through one of the computer's 
slots. IN stands for “input.” 


The command takes this form: 
IN#n 


The number, n, is the slot of the device from which to get information. 
The number can be from 0 to 7. When you use the IN# command, 
DOS will get information, or read, from the device connected through 
the specified slot. 


Use IN#0 to read information from the keyboard again. 


This command works the same on the Apple lle computer even though 
the lle does not have a slot 0. 


Example 

1. If your Apple computer has a telephone modem that connects toa 
telephone network and the modem is connected to slot 4, typing 
CON)GHIET)-(#4) 
causes DOS to read information from the network. 

2. To read information from the keyboard again, use the IN# 
command with slot number 0. 


Incidentally: You can start a disk in drive 1 by using the IN# command 
with the slot number of the disk controller card—just as you did with 
PR# command. 
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A Ways to Restart DOS 


There will be times when you will want to restart DOS. Forinstance, if 
your keyboard quits responding or the cursor disappears—referred 
to as a “hung” system—it is necessary to restart DOS. You may also 
want to restart DOS to make sure a new disk will start the system. 


When you have started up your computer with DOS, there are 
several methods you can use to restart DOS. They are listed in 
increasing order of severity. 


1. Type (CONTROL)-(RESET), This method does not affect the contents of 
main memory. This is the first method to try if your system hangs. 


2. Type CAOC). This is a BASIC command that 
reconnects DOS but does not affect the contents of main memory. 


3. Type (P\A\GHiFT)-(#)6) to restart DOS from drive 1, slot 6 on all 
models of the Apple II or type (@)-(CONTROL)-(RESET) on an Apple lle. 
These two methods destroy whatever is in main memory. This is 
the method you should use to test a new system disk. 


If you see the Monitor program's asterisk (*), type 
(6)(GONTROL)-(P), or 

(6)(ConTROL)-{k) to start DOS. 

Or type 

(that's a zero), or 

(these are zeros, too) to retart DOS. 


If your disk controller card is installed in a slot other than slot 6, 
replace 6 in these commands with the number of that slot. 


Rees Conclusion 


This is the end of the introduction to DOS. With what you have read 
so far, you now know enough to deal with reasonably complex 

disk operations. Once you are comfortable with the fundamental 
commands and concepts, you may want to try the advanced ones 
presented in the DOS Programmer's Manual. 
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AAA Chapter 5 Summary 


RUN fn [,Sn] [,Dn] [,Vn] copies a program (file type A or |) 
from a disk file into memory and 
then executes the program. 


LOAD fn [,Sn] [,Dn] [,Vn] copies a program (file type A or |) 
from a disk file into memory. 
Once the program is in memory, 
you can run it, modify it, or 
save it. 


SAVE fn [,Sn] [,Dn] [, Vn] writes a copy of the BASIC 
program currently in memory to 
a disk file. An Applesoft program 
is saved as type A. An Integer 
BASIC program is saved as 
type l. 


PR#n specifies where your computer 
should send information; that is, 
it designates a device, 
connected through one of the 
computer's slots, for output. 


IN#n specifies where your computer 
should get information; thatis, it 
designates a device, connected 
through one of the computer's 
slots, for input. 
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Example 
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Appendix B: Warnings and Error Messages 
DOS Messages 

DISK FULL 

END OF DATA 

FILE LOCKED 

FILE NOT FOUND 

FILE TYPE MISMATCH 

lO ERROR 

LANGUAGE NOT AVAILABLE 

NO BUFFERS AVAILABLE 

NOT DIRECT COMMAND 

PROGRAM TOO LARGE 

RANGE ERROR 

SYNTAX ERROR 

VOLUME MISMATCH 

WRITE PROTECTED 
Stopping a Program 
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An application program accomplishes 
some specific purpose or task, such as 
word processing or data-base 
management. 


A sector is a fixed fraction of a track. 
When you initialize a disk with DOS 3.3, 
DOS prepares the disk for information by 
dividing its surface into 35 tracks, each 
containing 16 sectors. 


Figure A-1. 13-Sector Versus 16-Sector 
Disks 


13-Sector Disk 


Appendix A 


Dealing With 13-Sector 
Disks 


This appendix is for people who have games or other application 
programs that don't run on their present system. If the disk drive 
keeps whirring when you attempt to start up a disk, and you have 
already checked to see that the disk is seated properly, you might 
have a 13-sector disk. 


Earlier versions of DOS (3.1 and 3.2) organized the surface of each 
track on a disk into 13 sectors. The version you have (3.3) uses a 
format that divides each track into 16 sectors (see Figure A-1). 
Changing from 13 sectors to 16 sectors gives you about 20 percent 
more space for information on each disk. 


However, 13-sector disks cannot be used with 16-sector DOS until 
they are converted. This appendix tells you how to: 


e convert 13-sector disks with the CONVERT13 program 
use 13-sector disks with the START13 program 


use the BASICS disk if you can't convert 13-sector disks because 
they're copy-protected 


Track 
35 tracks on each disk 


(16 sectors on a track) 


256 bytes of data 
stored in each sector 
of each track 


16-Sector Disk 
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A Converting a 13-Sector Disk: 
the CONVERT13 Program 


The CONVERT13 program on the SYSTEM MASTER disk converts 
a 13-sector disk and its programs to a 16-sector format. CONVERT13 
copies the contents of your 13-sector disk to an initialized 16-sector 
disk. 


CONVERT‘13 reads the information from a 13-sector disk and writes 
the information to a newly prepared 16-sector disk. The information 
on the 13-sector source disk is not changed in any way. 


Incidentally: You may be familiar with the MUFFIN program from a 
previous version of DOS. MUFFIN performed the same function as 
CONVERT13 does. In fact, CONVERT13 runs MUFFIN for you. 


Example 


This example uses CONVERT 13 to transfer information on a 
13-sector disk to a 16-sector disk. The 16-sector disk must already be 


If you need to know how to initialize initialized. 
a disk, see “Preparing a Blank Disk: the 


Nir SA, Chapter T: If your 13-sector disk is protected against copying (as are some 


commercially available disks), you won't be able to convert it, but you 
can still run the programs on it by using START13 and the BASICS 
disk (see the section “Running 13-Sector Disks Without 
Conversion.”) 


This example shows you how to use CONVERT13 with one disk 
drive. You may need to swap disks several times to convert an entire 
disk. 


Two Drives: When you are converting files and you have more than one 
disk drive, place the 13-sector disk in drive 1 and the newly prepared 
destination disk in drive 2 before conversion begins. When CONVERT 13 
asks for slot and drive numbers; specify 6 for both slot numbers (ifthat's 
the disk controller card's slot) and 1 and 2, respectively, for the source and 
destination disk drive numbers. 
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What You Do What You Get 


1. Putthe SYSTEM MASTER You'llsee EXECUTING 


disk in drive 1 and type MUFFIN briefly, then you'll 
GUNE=0000B0u0a (Fig nr wa ment 
and press (RETURN). 


Figure A-2. The CONVERT 13 Menu. 
Yousee MUFFIN VERSION D 
because CONVERT13 runs the binary 
MUFFIN program. 


Cursor 
2. To convert files, type The program starts up, and you'll 
see SOURCE SLOT? The 
0) program wants to know where to 
find the source (13-sector) disk. 
An expansion slot is a long connector and press (RETURN). First it asks for the expansion 
inside the computer for connecting a slot number and then the disk 
peripheral card. drive number. 


A peripheral card is a removable 
printed-circuit board that expands or 
modifies the computer's capabilities. A 
disk controller card is a peripheral card. 


Converting a 13-Sector Disk: the CONVERT13 Program 


A disk controller card is a peripheral 
card that connects one or two disk drives 
to the computer and controls their 
operation. 


3. To tell the program to look in 
the disk drive connected through 
slot 6, type 


®© 


and press (RETURN). If your disk 
controller card is in a different 
slot, type the number of that slot. 


4. To indicate the number of your 
disk drive that will contain the 
13-sector disk, type 


@ 


for drive 1 and press (RETURN). 


5. Type 
G 


for slot 6 and press (RETUAN). If 
your disk controller card is in a 
different slot, type the number of 
that slot. 


6. Type 
0 


for drive 1 and press (RETURN), 
You have now told CONVERT13 
to use drive 1 for both the source 
and destination disks. 


7. Type 


© 
and press (RETURN). The equal 


sign is a character that stands for 
all the files on the disk. 
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The next prompt will appear on 
the display, DRIVE? 


Then you'll see 
DESTINATION SLOT? 
as the program asks where to 
put the converted files. The 
destination disk is the 16-sector 
disk. 


You'llsee DRIVE? 


Now the program asks for 
the name of the file with 
FILENAME? 


You'llsee DO YOU WANT 
PROMPTING? The program 
is giving you the chance to 
double-check that you want 
each file converted before 
CONVERT13 starts the process. 


Ifyou do not want to convert all the files 
on the 13-sector disk, type 

instead. Then when each file's name 

is displayed, you must tell the 

program whether to convert the file 

or not by typing (Y) or ®. (Or (a) 

if you want to end the conversions and 
return to the menu.) 


8. Type 
(y) 


for “no” prompting and press 
(RETUAN). All the files will be 
converted automatically. 


9. Remove the SYSTEM 
MASTER disk from drive 1. 


10. Put the 13-sector disk into 
the disk drive. Press 
to begin. 


11. Insert the 16-sector disk that 
you prepared with the INIT 
command; press (RETURN). 


12. If there are more files on the 
source disk, CONVERT13 
instructs you to insert the source 
disk again. 


Repeat steps 10 and 11 as 

the program alternately reads 
from the source disk and writes 
to the destination disk until 
each 13-sector file has been 
converted and moved to the 
new disk. 


You'llsee INSERT 


DISK(S). THEN PRESS 
¿ESC* TO RETURN TO 
MAIN MENU OR ANY 
OTHER KEY TO BEGIN. 


This message gives you a 
chance to change your mind 
about converting the disk. If you 
wanted to do this (don't try it 
now), you'd simply press (Esc). 


From here on, you'll be working 
with two disks: your 13-sector 
disk and your newly prepared 
16-sector disk. 


CONVERT 13 finds the first file 
on your 13-sector (source) disk 
and displaysits name: FILE 
HELLO. Then you'll see 
INSERT DESTINATION 
DISK AND PRESS ANY 
REY, 


CONVERT13 puts a 16-sector 
version of the file on the new disk 
and reports DONE. 


Eventually, you'll see 

PRESS ANY KEY TO 
CONTINUE. This means 
CONVERT13 is done converting 
all your files. 


Converting a 13-Sector Disk: the CONVERT13 Program a 


The wildcard can stand for any 
character or sequence of characters 
in a filename. See Chapter 4 for more 
information. 


13. Press (RETURN). You'll see CONVERT13’s menu 
again. 


14. To return to the prompt, type 
B 


to “quit” and press (RETURN). 


You can now use the 16-sector disk, with the converted 13-sector 
files, as described in the DOS 3.3 manuals. 


Duplicate Filenames 


If you try to convert a 13-sector file with the same name as a file 
already on the destination disk, you'll see: 


FILE [filenamel 
ALREADY EXISTS, 
TYPE IN A NEW FILE NAME FOR THE COPY 
OR <RETURN> TO REPLACE EXISTING FILE 
OR <CONTROL-C><RETURN> TO CANCEL COPY 


Once you have received this message, you may: type a new 
name for the file to be converted; press and have the 
converted 13-sector file replace the file currently on the 16-sector 
disk; or type and to stop the conversion. 


The Wildcard Character 


As you saw in the CONVERT13 example, you may use the wildcard 
character, an equal sign, to mean all files on the disk. You may also 
use it to stand for any character or group of characters within a 
filename. For example, if yourespondto FILENAME? bytyping 
(MENE), CONVERT 13 converts all files whose names begin with F 
and end with LE. 


When you use the wildcard, CONVERT13 asks DO YOU WANT 
PROMPTING? Tohave CONVERT13 stop after finding each file 
on the 13-sector disk and ask you to confirm that you want to convert 
it, type (Y) and press (RETURN). To convert all the files in the wildcard 
group without checking each one, type (N) and press (RETURN). Once 
the prompting has begun, if you want to end the conversions and 
return to the menu, type (9) and press (RETURN). 
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A Running 13-Sector Disks Without 
Conversion 


Figure A-3. The START 13 Title Screen 


Cursor 


Both the START 13 program and the BASICS disk can be used to run 
13-sector disks on your 16-sector system. The START 13 program 
and the BASICS disk are designed to allow you to use a 13-sector 
disk when that disk is protected against copying. 


The BASICS disk is no longer supplied with DOS because the START13 
program is easier to use. Programs you have purchased may tell you to 
“boot the BASICS disk.” You can use START13 instead. 


Using the START13 Program 


The START13 program loads information from a 13-sector disk into 
memory. Essentially, START 13 is a special loader that allows your 
system to start up 13-sector disks. 


- 13-SECTOR BOOT UTILITY 


COPYRIGHT APPLE COMPUTER INC; 1979 


SLOT TO BOOT FROM (DEFAULT = 6)? | 
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You may have a BASICS disk if you have 
an older version of DOS. 


Example 


This example shows how to use START13 to read information from a 
13-sector disk. 


1. Putthe SYSTEM MASTER disk in drive 1 and execute the 
START13 program by typing 


(RY U)N)(SPACES) TARY TI 13) 


Press (RETURN). The message EXECUTING BOOT13 
appears briefly. Then you'll see the title screen illustrated in 
Figure A-3. 


2. Whenyousee 13-SECTOR BOOT UTILITY, followed by 
SLOT TO BOOT FROM (DEFAULT=G)?, remove the 
SYSTEM MASTER and insert your 13-sector disk in drive 1. 


3. Press if your disk controller card is connected through 
slot 6. If your card is in another slot, enter the number of that slot 
before you press (RETURN), 


If your 13-sector disk is a startup disk, the startup program on that 
disk will start executing. For example, if your 13-sector disk holds 
Apple Writer 1.0, you should be looking at Apple Writer's menu. 


Incidentally: If you have used an earlier version of DOS, you may be 
familiar with the BOOT13 program. BOOT13 performed the same 
function that START13 does. In fact, START13 runs BOOT13 for you. 


Using the BASICS Disk 


The BASICS disk also loads information from a 13-sector disk into 
memory, allowing a program to both read and write in 13 sectors. 
When you use the BASICS disk to work with 13-sector files, you must 
start the computer with the BASICS disk instead of the SYSTEM 
MASTER. 


Boot the BASICS Disk: If you read “boot the BASICS disk” in some older 
Apple manual, you can either start the BASICS disk (described next) or 
run the START13 program. 


To use a 13-sector disk on your 16-sector system, put the BASICS 
disk in drive 1 (connected via slot 6) and turn the computer on. When 
you see this on your display 


INSERT YOUR 13-SECTOR DISKETTE 
AND PRESS RETURN 


insert any 13-sector disk and press (RETURN), 
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Note that the BASICS disk itself does not contain DOS; trying to use DOS 
when you have started up the computer with the BASICS disk will produce 


garbage on your display. 


If a program automatically runs, it means that your 13-sector disk 
contains a turnkey program, and you're all set. If only a cursor 
appears on your display, it means that your 13-sector disk does not 
contain a turnkey program; type CATALOG to see a list of the files on 
the disk, and use the RUN command to execute the program you 
want. 
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Appendix B 


Warnings and Error 
Messages 


An error message alerts you to a problem and indicates that a 
command you have issued is incompatible with DOS's rules about 
that command. The form of an error message tells you whether it 
comes from DOS or from one of the BASIC languages. 


Form Message Sent By: 


SYNTAXERROR DOS 

2SYNTAX ERROR _ Applesoft BASIC 

** SYNTAX ERR Integer BASIC 

This appendix discusses only DOS errors. Applesoft and Integer 
BASIC error messages are documented in their respective manuals. 


This appendix explains the possible causes of each error message 
and suggests what to do to correct the problem. 


Warnings and Error Messages a 


Di DOS Messages 


Table B-1. DOS Error Messages 


DOS messages are summarized in Table B-1. A discussion of each 
error message, including a description of causes and cures, follows 
the table. The error messages are discussed in alphabetic order. 
The error messages are discussed in alphabetic order. 


Message Most Common Cause 

DISK FULL Too many files in the catalog or all sectors on disk used 

END OF DATA Reading beyond end of text file 

FILE LOCKED Attempt to write to, delete, or rename a locked file 

FILE NOT FOUND Filename misspelled or file not on disk 

FILE TYPE MISMATCH Command doesn't match file type 

1/0 ERROR Door open, disk not initialized, bad disk drive, or bad disk 

LANGUAGE NOT Language required is not present in computer 
AVAILABLE 


NO BUFFERS AVAILABLE Too many text files are open 

NOT DIRECT COMMAND Command must be in a program 

PROGRAM TOO LARGE Insufficient memory available 

RANGE ERROR Command value is too large or too small 

SYNTAX ERROR Bad filename or value 

VOLUME MISMATCH Wrong volume number 

WRITE PROTECTED Write-enable notch not present or covered by write-protect 
tab 


DISK FULL 


DISK FULL means that DOS tried to store information on a disk 
when no more space was available. In this situation, DOS closes all 
files and saves all the information that it can. 


When you geta DISK FULL message, you can delete a file 
or two on the current disk before trying to save the information in 
memory. Or you can change disks and save the information in 
memory on a disk that has more room. 


If you receive this message and try again to save a file on the full disk, 
the sector length of one of the existing files in that disk's catalog will 
be set to zero. Despite the odd appearance of that catalog entry, the 
existing file itself will not be damaged in any way. 


END OF DATA 


END OF DATA means that your program tried to retrieve 
information from an area of the text file where there is no information. 


Any byte beyond the last field in a sequential-access text file or 
beyond the last field of each record in a random-access text file may 
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ASCII stands for the “American Standard 
Code for Information Interchange.” 


The MASTER program is explained in 
the DOS Programmer's Manual. 


contain the value 0. The zero character is the ASCII code for a null 
character. Any text file command that tries to read this character 
producesthe END OF DATA message. 


You may alsosee END OF DATA afteran INPUT ora GET 
command if they were used incorrectly in your program. 


To keep any data from being lost when youseethe END OF 
DATA message, issuethe CLOSE command. See the DOS 
Programmer's Manual for more information on how to fix your 
program. 


FILE LOCKED 


FILE LOCKED means you tried to save, write to, change, 
append, delete, or rename a file that is locked. Check the catalog: the 
name of a locked file is preceded by an asterisk (+). To unlock the 
file, use the UNLOCK command. 


FILE NOT FOUND 


FILE NOT FOUND means that you specified the name of a file 
that is not on the disk that you are currently using. 


These are the most likely causes: 


e You may have misspelled the filename by typing the filename 
incorrectly or by omitting the comma that separates the filename 
from another argument. Check your typing carefully. Check the 
catalog for the exact spelling of the filename. 


e The file is not on the disk you specified. Check the catalog. 


e The file has been accidentally deleted from the disk. Check the 
catalog. 


e Ifyousee FILE NOT FOUND each time you start a disk, 
you must tell DOS the name of a greeting program on that disk. If 
you have no files on the disk that you want to keep, you can 
initialize the disk again using the INIT command—remember, the 
INIT command erases anything that was on the disk. If you cannot 
remember the name of the greeting program that is already on the 
disk, run the MASTER program to rename the greeting program. 


DOS Messages age 


Table B-2. Types of Files According to 
Command 


The INIT command is discussed in 
Chapter 3, “Preparing Disks.” 


FILE TYPE MISMATCH 


FILE TYPE MISMATCH means that a DOS command 
specified a filename that is already assigned to a file whose file type 
is inappropriate to the present command. 


Use the CATALOG command to check the type of the file. Then look 
at Table B-2 to make sure that the command you are using is legal 
with that file type. 


If you are sure that the command is correct, use a filename that is not 
on the disk, use a different disk, rename the existing file, or delete the 
existing file. 


Command Legal File Type 
LOAD, RUN, SAVE Applesoft or Integer BASIC 
CHAIN Integer BASIC 


OPEN, READ, WRITE, Text 
APPEND, POSITION, 
EXEC 


BLOAD, BRUN, BSAVE Binary 


VO ERROR 


1/0 ERROR means that DOS is unable to store information ona 
disk or to retrieve information from a disk. DOS tries 96 times before it 
gives you this message. 


This message can occur because: 


e The door to the disk drive is open. Close it. 


e No disk is in the selected or default disk drive. Put a disk into the 
drive and close the drive door. 


e The disk in the drive has not been initialized. Prepare the disk 
using the INIT command. 


e The disk is inserted incorrectly. Gently remove the disk from the 
disk drive and insert it again. 


e The VERIFY command is indicating that a file is not stored 
correctly on the disk. 


e A16-sector version of DOS is trying to use a 13-sector disk. See 
Appendix A. 
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Restart procedures are explained in 
Chapter 5, “Ways to Restart DOS.” 


e The drive number (Dn) argument specified a disk drive that does 
not exist in your system. A non-existent drive is now the default 
drive. Specify the correct drive number with the next DOS 
command. 


e The slot number (Sn) argument specified a slot that does not 
contain a disk controller card. An erroneous slotis now the default 
slot, and DOS assumes that the disk that isn't connected to the slot 
is still running. Even ifthe next DOS command specifies the right 
slot, DOS waits in limbo forever for the non-existent disk to 
respond to the last command. 


Ifyou have no program in memory that you want to save, simply 
restart DOS. To recover with your program intact, do this: 

1. Press (RESET). 

2. Type (CYAl TIAL 0)(G)(SPACEY Sn), where n is the correct slot number. 


Ifthisleadstoa SYNTAX ERROR, itmeans that DOS has 
been disconnected. To reconnect DOS, type 


00000008 
ifyou have a BASIC prompt, or type 
(that's a zero) 

ifyou have the Monitor's asterisk. 


3. Then issue the catalog command again—CATALOG, Sn—and 
everything should be fine. 


In any case, issue a VERIFY command to make sure the file you are 
working with is stored correctly on the disk. If the information is not 
stored correctly and is still in memory, try storing it again. 


LANGUAGE NOT AVAILABLE 


You willsee LANGUAGE NOT AVAILABLE whenDOS 
cannot find Integer or Applesoft BASIC. The commands FP, INT, 
LOAD, or RUN all initiate a language search. 


You will see this message after you issue a command that requests 
Applesoft from the disk in the current drive and that disk does not 
contain the APPLESOFT or FPBASIC programs. Replace the disk 
with a disk that contains these programs (for example, the SYSTEM 
MASTER disk) and issue the command again. 
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The contents of read-only memory, or 
ROM, can only be read. Information 

is written into ROM once, during 
manufacture, and it stays there 
permanently, even when the computer 
is turned off. 


The contents of random-access 
memory, or RAM, can be read from 
or written to. When you turn off the 
computer, the contents of RAM are 
erased. 


You also will see this message after you issue a command that 
requests Integer BASIC and Integer BASIC is not in your computer. 
As long as your computer has enough memory to use both Applesoft 
and Integer, you can load Integer BASIC into memory from the 
SYSTEM MASTER disk. 


When you request Applesoft, DOS looks for the language in ROM, 
read-only memory, or on a language card. If Applesoft is not there, 
DOS looks in RAM, random-access memory. When Applesoft is 
not in RAM, DOS looks on the disk in the current disk drive (the most 
recent values of the slot and drive number arguments). 


When you request Integer BASIC, DOS looks for that language in 
ROM or RAM. 


If you started DOS from the SYSTEM MASTER and get the 
LANGUAGE NOT AVAILABLE message, it means that you 
don't have enough space in your computer (64K or more) for both 
languages. 


NO BUFFERS AVAILABLE 


Each open file and each DOS command (except PR#, IN#, and 
MAXFILES) requires a file buffer. NO BUFFERS AVAILABLE 
means that you or your program tried to open one more file or issue 
one more DOS command than there were buffers available in 
memory. 


Issue the CLOSE command to release the file buffers, or issue the 
MAXFILES command to increase the number of file buffers. To find 
out how to increase or decrease the number of file buffers, see the 
MAXFILES command in the DOS Programmer's Manual. 


NOT DIRECT COMMAND 


NOT DIRECT COMMAND: means that you tried to use an 
APPEND, OPEN, POSITION, READ, or WRITE command in 
immediate execution. These commands can be used only within 
PRINT statements in a program; they are described in the DOS 
Programmer's Manual. 


This message also can occur when a program is stopped and 
restarted. Using a POKE command will repair the error. Type 


DOGGG 3500 R08000G 
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PROGRAM TOO LARGE 


PROGRAM TOO LARGE means that a DOS command tried to 
load a disk file and found insufficient space in main memory for the 
contents of that file. 


If you are in immediate execution, try issuing an FP or INT command, 
whichever is appropriate to your program. When DOS executes an 
The FP and INT commands are used FP or INT command, it examines memory and consolidates all the 


to switch between the two BASIC available space. This will remove the gaps in memory that some 
languages. See your BASIC manual. 
programs cause. 


You may also get this message if there is a problem with the program 
you are running. lt also may indicate that a previous program set 
HIMEM: or LOMEM: to values that will not allow your present 
program to be loaded. 


You can use the MAXFILES command to decrease the number of file 
buffers that are available to your BASIC program, or you can use 
POKE to place the correct values into the HIMEM: or LOMEM: 
locations. To find out more about these programmming fixes, see the 
DOS Programmer's Manual. 


RANGE ERROR 


RANGE ERROR means thatthe value of a command's argument 
is too large or too small. Table B-3 shows which values can be used 


with which arguments. 
Table B-3. Minimum and Maximum A Mini Maxi 
Argument Values. Note: Using PR# and rgument Umum: KALMU 
IN# with arguments of 8 to 16 may give All Files: Slot s 1 7 
unpredictable results. j Drive D 4 2 
Volume V 0 254 
Sequential Byte B 0 32767 
Text Files: Relative Field R 0 32767 
Absolute Field (EXEC) R 0 32767 
Random-Access Record Length E 1 32767 
Text Files: Record Number R 0 32767 
Binary Files: Starting Address A 0 65535 
Number of Bytes L 1 32767 
DOS Commands: PR#n n 0 16 
IN n n 0 16 
MAXFILES n n 1 16 


Using values beyond the range specified in Table B-3 does not 
always causethe RANGE ERROR message. Any DOS 
command with a value specified that is less than 0 or greater than 
65535 may returna SYNTAX ERROR. 
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SYNTAX ERROR 


SYNTAX ERROR means that you or your program issued a DOS 
command with an incorrect value or incorrect separator (comma or 
space). You will also see this message when the command lacks a 
required argument. Check the command's syntax and then try again. 


The most common cause for this error message is a simple typing 
mistake. Check your spelling and then try again. 


VOLUME MISMATCH 


VOLUME MISMATCH means that the volume number (Vn) used 
in a DOS command differs from the volume number assigned to the 
disk when it was initialized. Use the CATALOG command to check 
the volume number of the disk. 


WRITE PROTECTED 


WRITE PROTECTED means that DOS is unable to save, write, 

or delete information on a specified disk. Write-protected means that 
the disk has no write-enable notch or that the notch is covered witha 
write-protect tab. 


These are the most likely causes: 
e There is an adhesive tab (write-protect tab) over the disk's write- 


enable notch. You may remove the tab and issue the command 
again. 


If you receive this message while running the copy program, you 
may have inserted the disk into the drive incorrectly. Check the 
disk’s position in the drive. 


There may be no write-enable notch on the disk. Choose another 
disk to save your file on. 
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AA Stopping a Program 


Occasionally, you will need to interrupt a program. Here are several 
things to try. They are listed in order of increasing severity. 
Eventually, your program will stop. 


As 


Press (Eso). It's in the upper-left corner of your keyboard; it helps 
you “escape” from the program. 


2. Press (CONTROL)-C). This cancels a program. 
3. Press and then (RETUAN). This cancels a program more 


Stopping a Program 


emphatically. 


. Press (CONTROL)-(RESET), This will stop your program and may return 
you to its opening menu. The program usually stays in memory. 


. If you have an Apple lle, hold down ©) and then press 
(CONTROL)-(RESET). Release (3) last. This is a very drastic measure, 
and it erases anything that is in main memory. 


. Turn off the power. You will rarely have to go this far to exit froma 
program. But it is a powerful way to show the computer who's 
boss. It does erase whatever programs and information you had in 
memory. 


Note: When you see a hyphen joining two keys, it means to press the 

keys simultaneously. For instance, (controt)-(RESET) means you should 
press and at the same time. In actual practice, you probably 
will press first and then, while still holding down (cosrao»), 

press (RESET), 
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Programs on the DOS 
Disks 


This appendix lists all of the programs that come on the SYSTEM 
MASTER and SAMPLE PROGRAMS disks. 


A Programs on the SYSTEM MASTER Disk 


This section briefly describes the programs on the SYSTEM 
MASTER disk. When the program is used in this manual, it is marked 
with a cross (+). To find where the program is discussed, check the 
Index. When an entry does not have a cross (+), the programis 
covered in the DOS Programmer's Manual. 


HELLO is an Applesoft greeting program that DOS 
runs automatically, ifthe Applesoft language 
is available, when DOS is started. (+) 


APPLESOFT is an Integer BASIC greeting program that 
DOS runs automatically, if the Applesoft 
language is not available, when DOS is 


started. 

BOOT13 is abinary program that starts up 13-sector 
disks, which were created under earlier 
versions of DOS. 

CHAIN is a binary program that loads and runs a 


second program without erasing from memory 
the variables and arrays of the first. Both 
chained programs must be Applesoft BASIC. 


CONVERT13 is an Applesoft BASIC program that runs the 


MUFFIN program, which converts 13-sector 
disks to 16-sector disks. (+) 
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COPY is the copy program to use when you are 
running Integer BASIC. (+) 


COPYY.OBJO is amachine-language program used by 
COPY and COPYA. 
COPYA is the copy program to use when you are 


running Applesoft BASIC. (+) 


FID is a binary program that performs several 
support functions for DOS. 
FILEM is an Applesoft program that runs FID, a 


binary program, so that you can perform disk 
functions with groups of files. (+) 


FPBASIC is the Applesoft BASIC language on disk; it is in 
binary code. 

INTBASIC is the Integer BASIC language on disk; it is in 
binary code. 


LOADER.OBJO is a machine-language program loaded by 
HELLO on the SYSTEM MASTER disk. 
LOADER.OBJO loads the alternate language 
into the language card or main memory. When 
the alternate language already exists in the 
computer, no action is taken. 


MASTER is an Applesoft program that runs the MASTER 
CREATE program, a binary program, so that 
you can convert an initialized disk to a master 
disk. 


MASTER CREATE is a binary program that converts an initialized 
disk into a master disk. 


MUFFIN is a binary program that converts your 
13-sector disks to 16-sector format. 


RENUMBER is an Applesoft program (a programming tool) 


that can renumber the statements of your 
BASIC program and merge two programs. 
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SLOT# is an Applesoft program that returns the 
current default values for slot and drive. (+) 


START13 is an Applesoft program that runs BOOT13, 
which starts up 13-sector disks that were 
created under earlier versions of DOS. (+) 


Ss Programs on the SAMPLE PROGRAMS Dis 


This section briefly describes the programs on the SAMPLE 
PROGRAMS disk. Many of these programs were used in this manual 
to demonstrate DOS commands. If so, the program is marked with a 
cross (+). To find where the program is discussed, check the Index. 
When an entry does not have a cross (+), the program is covered in 
the DOS Programmer's Manual. 


HELLO is an Applesoft greeting program. (+) 


ADDRESS is asample program written in Applesoft that 
illustrates reading and writing of random- 
access text files. It uses BLACK BOOK to hold 
the data. 


ANIMALS is agame written in Integer BASIC for which 
you build a data file. 


APPLE PROMS is a data file for the RANDOM program. It 
contains data for a parts list. 


APPLESOFT is an Integer BASIC greeting program that 
DOS runs automatically, if the Applesoft 
language is not available, when DOS is 
started. 


APPLEVISION is ademonstration program, written in machine 
language, with an interface to Integer BASIC. 


(+) 


BLACK BOOK is a data file that stores the records of the 
ADDRESS program. 
BRICK OUT is agame program, written in Applesoft, that 


uses game paddles or the arrow keys on the 
keyboard. (+) 
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COLOR TEST 


DELETE.ME.1 


DELETE.ME.2 


DELETE.ME.3 


EXEC DEMO 


FPBASIC 


GET TEXT 


INTBASIC 


LOADER.OBJO 


LOCK.ME.1 


LOCKED.UP.1 


LOCKED.UP.2 


MAKE TEXT 


is a demonstration program, written in 
Applesoft, that helps you adjust a color TV set. 
(+) 


is a demonstration program, written in 
Applesoft, that lets you practice deleting a file. 


(+) 


is a demonstration program, written in 
Applesoft, that lets you practice deleting a file. 


(+) 


is a demonstration program, written in 
Applesoft, that lets you practice deleting a file. 


(+) 


is a program, written in Applesoft, that 
demonstrates how an EXEC program is 
created and used. 


is the Applesoft BASIC language on disk; it is in 
binary code. 


is a sample Applesoft program that reads text 
files. 


is the Integer BASIC language on disk; it is in 
binary code. 


is a machine-language program loaded by 
HELLO on the SAMPLE PROGRAMS disk. 
LOADER.OBJO loads the alternate BASIC into 
the language card or main memory. If the 
alternate language already exists in the 
computer, no action is taken. 


is ademonstration Applesoft program that lets 
you practice locking an unlocked file. (+) 


is ademonstration Applesoft program that lets 
you practice unlocking a locked file. (+) 


is ademonstration Applesoft file that lets you 
practice unlocking a locked file. (+) 


is asample Applesoft program that illustrates 
how to create sequential text files. 
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ONERR DEMO is a sample program that illustrates error 
recovery. lt checks to see if a file is locked and, 
if so, lets you unlock it. 


POKER is a sample program, written in Applesoft, that 
translates machine-language into a text file. 

PHONE LIST is ademonstration Applesoft program. (+) 

RANDOM is a sample program, written in Applesoft, that 


illustrates reading and writing with a random- 
access text file. lt uses APPLE PROMS to hold 
the data. 


VERIFY.ME is a demonstration Applesoft program that lets 
you practice verifying a file. (+) 
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Appendix D 


Summary of DOS 
Operating Concepts and 
Commands 


This appendix contains only the concepts, commands, and programs 
covered in the DOS User's Manual. For a more complete summary, 
refer to the DOS Programmer's Manual. That manual also has a 
summary card that you can tear out for easy reference. 


AAA Operating Concepts 


DOS operates on all models of Apple II computers: the Apple II, the 
Apple II Plus, and the Apple lle. Information and procedures that 
apply only to a specific model are indicated explicitly. 


Starting Up 

Starting up is the process of turning on the power to your computer 
(or simulating this same sequence) so that DOS is loaded into main 
memory. (See Chapter 1) 

1. Inserta DOS disk into disk drive 1. 


2. Turn on your display device, either a video monitor or a television 
set. 


3. Find the power switch on the computer and turniton. 
On an Apple lle computer, you can simulate a startup once the power 


is on. Hold down (3), and then press (CONTROL)-(RESET), Release 
(RESET), (CONTROL), and then ©. 
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Restarting DOS 


Restarting is the process of reconnecting DOS when the power is 
already on. Some restart methods do not affect the contents of main 
memory. Others destroy what is in main memory. The methods are 
listed in order of increasing severity. 


1. Press (CONTROL)-(RESET). This method does not affect the contents of 
main memory. This is the first method to try if your system is stuck. 


2. Type [cla Erace o fo (2). This is a BASIC command that 
reconnects DOS but does not affect the contents of main memory. 


3. Type (P\A\GHIFT)-(#)6) to restart DOS from drive 1, slot 6 on all 
models of the Apple II or press (5)-(CONTROL)-(RESET) on an Apple lle. 
These two methods destroy whatever is in main memory. This is 
the method you should use to test a new system disk. 


4. Type one of these: 
(6)(GONTROL)-(P) 
(6)(GONTROL)-(k) 
(that’s a zero) 
(these are zeros, too) 


if you see the Monitor program’s asterisk (*). If your disk controller 
card is installed in a slot other than slot 6, replace 6 in these 
commands with the number of that slot. 


Capacity 


A maximum of 496 disk sectors is available to the DOS user. Each 
disk sector can store up to 256 bytes of information. 


Minimum file length is one sector for an empty text file (occupied by 
the track/sector list for the file) and two sectors for empty Applesoft 
BASIC, Integer BASIC, and binary files (one for the track/sector list 
and one for the first program sector, which contains the program's 
length.) 
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Ares Notation 


Here is an explanation of the notation used in this manual to indicate 


command syntax: 

UPPERCASE indicates the actual name of something, like a 
DOS command. Type it exactly as indicated. 

lowercase indicates something you supply, like the name 
ofa program. 

fn indicates a filename that you supply. 

[] indicates an optional argument in a command. 
You may include the option or not, as you 
choose. In any case, don't type the brackets. 

n indicates a number you supply. 

Syntax 


A filename usually is the first argument after a command word; 
remaining arguments may appear in any order. Use a comma to 
separate the filename from an argument that follows. (See Chapter 2) 


For example, 
INIT fn [,Vn] [,Sn] [,Dn] 


indicates the INIT command's syntax and should be interpreted this 
way: 


e The command word INIT is uppercase and should be typed 
exactly as shown. 


e The argument fn stands for “filename,” and you should type an 
actual name in place of fn when you issue the command. 


e The argument Vn is an optional argument. lt stands for “volume 
number.” When you use this argument, you should type the V (it's 
in uppercase) and then the number you want. 


e The argument Sn is an optional argument. It stands for “slot 
number.” When you use this argument, you should type the S (it’s 
in uppercase) and then the number you want. 


e The argument Dn is an optional argument. It stands for “drive 
number.” When you use this argument, you should type the D (it's 
in uppercase) and then the number you want. 
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Arguments 


Here's a quick run down of the arguments used in DOS commands. 
For more detailed information, see Chapter 2. 


e fn stands for “filename.” 


Afile's name may be from one to 30 characters. lt must begin with 
a letter. Any typeable character except the comma may appear in 
afilename. 


e n stands for “number.” 
You may use integer or hexadecimal numbers. 
e D stands for “drive.” 


This argument must be used with a number, either 1 or 2. lt 
specifies the disk drive you want to use. The drive number initially 
defaults to 1. Subsequently it defaults to the last drive number 
specified. 


e S stands for “slot.” 


This argument must be used with a number, 1 through 7. It 
specifies the expansion slot you want to use. It initially defaults to 
the number of the slot from which DOS was started. Subsequently 
it defaults to the last slot number specified. 


e V stands for “volume.” 


This argument must be used with a number, 0 through 254. It 
specifies the volume number you wantto use. It initially defaults to 
the volume number of the disk from which DOS was started. 
Subsequently it defaults to the last volume number specified or 
read from a disk. When omitted in the INIT command, the volume 
number defaults to 254. This argumentis rarely used. 
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AAA Command Summary 


All DOS commands are summarized in 
the DOS Programmer's Manual. 


Only the DOS commands covered in this manual are included in this 
appendix. The command summaries are listed in alphabetical order. 


The chapter the command is discussed in is indicated. 


CATALOG 
Syntax: CATALOG [,Sn] [,Dn] 


Example: CATALOG 


This command displays a listing of the contents of the specified disk. 
It displays the volume number and the names of all the files on your 
disk, as well as some information about each file: whether the file is 
locked, what its file type is, and its size in sectors. 


In the catalog, an asterisk indicates that the file is locked. 
The file types are 


Applesoft BASIC program file, created by SAVE. 
Binary memory-image file, created by BSAVE. 
Integer BASIC program file, created by SAVE. 
Relocatable, assembly-language file (see the 
6502 Assembler/DOS Tool Kit) 

For future use. 

Text file, created by OPEN and filled by WRITE. 
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When an individual file exceeds 255 sectors, the CATALOG display 
of that file's length starts over at 000. This gives an erroneous 
impression of the size of the file and the remaining space on the disk. 


See Chapter 3. 


DELETE 
Syntax: DELETE fn [,Sn] [,Dn] [,Vn] 


Example: DELETETEST 
This command removes a file from a disk. The file must be unlocked. 


When the specified file does not exist on the disk, DOS displays the 
message FILE NOT FOUND. 


See Chapter 4. 
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INF 
Syntax: IN#n 


Example: IN#6 

This command reads the information, normally input from the 
keyboard, from the device that is connected through slot n. The # 
character is part of the command and must be typed. 

Use IN#0 to direct DOS to read input from the keyboard once again. 
When no controller card is in the slot you specified, DOS appears to 
be disconnected, and you have to restart the computer. (See the first 
section of this appendix.) 


See Chapter 5. 


INIT 
Syntax: INIT fn [,Sn] [,Dn] [,Vn] 


Example: INIT HELLO, V18 


This command initializes a disk. In other words, it prepares a disk to 
receive information. The command divides the surface of the disk 
into tracks and sectors and places a copy of DOS and a greeting 
program on the disk. 


See Chapter 3. 


A Warning 


The INIT command wipes a disk clean. Be sure there is nothing you want 
to keep on the disk before you use this command. 
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LOAD 
Syntax: LOAD fn [,Sn] [,Dn] [,Vn] 


Example: LOAD DOW JONES, S6, D1 


This command gets a copy of a program (file type A or |) from a disk 
file and puts itinto main memory. Once the program is in memory, 
you can run it, modify it, or save it. 


Before loading the new program into memory, DOS closes any files 
that are open, erases the contents of main memory, and changes to 
the BASIC that corresponds with the named file’s type. 


If the file type is A and Applesoft is neither in memory nor available 
from firmware, DOS looks for Applesoft on a disk. When Applesoft is 
not on the disk or your computer is not large enough to have room 
for both BASIC languages, DOS displays LANGUAGE NOT 
AVAILABLE. 


If the file type is |, DOS looks for Integer BASIC in RAM (the language 
card) and then ROM. When DOS cannot find or load the language 
you need, itdisplays LANGUAGE NOT AVAILABLE. 


See Chapter 5. 


LOCK 

Syntax: LOCK fn [,Sn] [,Dn] [,Vn] 

Example: LOCKLOVE LETTERS, D2 

This command protects a file from being accidentally altered. The 
entry for a locked file is preceded by an asterisk in the catalog . You 


cannot rename, delete, or change a locked file until it is unlocked. 


See Chapter 4. 
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PRA 
Syntax: PR#n 


Example: PR#6 


This command sends the characters normally printed on the display 
to another device, such as a printer, that is connected through slot n. 
The # character is part of the command and must be typed. 


Use PR#0 to direct output back to the display. If you have an 
Apple lle computer with an 80-column text card, use PR#3 to 
direct output back to the display. 


When no controller card is in the slot you specified, DOS appears to 
be disconnected, and you have to restart the computer. (See the first 
section of this appendix.) 


See Chapter 5. 


RENAME 

Syntax: RENAME fn1,fn2 [,Sn] [,Dn] [, Vn] 

Example: RENAME CURRENT, NEW, S5, D1 

This command changes the name of a file from fn1, the current 
filename, to fn2, the new filename. The contents of the file are not 
affected. RENAME does not check to see whether the new name, 
fn2, already exists. 


See Chapter 4. 


RUN 
Syntax: RUN fn [,Sn] [,Dn] [,Vn] 


Example: RUN ANNUITY, D2 


This command takes a copy of a BASIC program (file type A or |) from 
a disk file, puts it into memory, and executes the program. 


See Chapter 5. 


jsa Summary of DOS Operating Concepts and Commands 


SAVE 
Syntax: SAVE fn[,Sn][,Dn] [,Vn] 


Example: SAVE COLOR DEMOS, D2 


This command writes the BASIC program currently in main memory 
to a disk file. An Applesoft BASIC program is saved as file type A. An 
Integer BASIC program is saved as file type l. 


When a file with that name does not exist on the disk, DOS creates a 
new file and stores the program currently in memory in that file. If the 
disk already contains a file with the same filename and the same file 
type, DOS writes the program currently in memory over the contents 
of the existing file. When the disk contains a file with the same 
filename and a different file type, DOS displays FILE TYPE 
MISMATCH. 


See Chapter 5. 


UNLOCK 
Syntax: UNLOCK fn [,Sn] [,Dn] [, Vn] 


Example: UNLOCK RECIPES, D2 


This command removes protection from a locked file, making it 
possible to rename, delete, or change it. 


See Chapter 4. 


VERIFY 

Syntax: VERIFY fn [,Sn] [,Dn] [,Vn] 

Example: VERIFY SAM 

This command makes sure that a file is stored properly on a disk. 

It tests whether DOS is able to read the file from the disk into the 
computer's memory. 

When DOS can read the file, DOS displays no confirming message. 
When DOS cannot read the file, it displays I/0 ERROR. You 
may verify any type of file. 


See Chapter 4. 
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This glossary includes computer terms that appear in this manual 
as well as some you may encounter in other Apple Computer, Inc. 
publications. 


Applesoft BASIC: An extended version of the BASIC programming 
language, capable of processing numbers in floating-point form, 
used with the Apple II computer. An interpreter for creating and 
executing programs in Applesoft is built into the firmware of the Apple 
II Plus and Apple lle systems. Compare Integer BASIC. 


application program: A program that puts the resources and 
capabilities of the computer to use for some specific purpose or task, 
such as word processing, data-base management, graphics, or 
telecommunications. 


application software: The component of a computer system 
consisting of application programs. 


argument: An argument stands for a value that should be used 
with a command. In DOS commands, the common arguments are 
filename (fn), slot number (Sn), drive number (Dn), and volume 
number (Vn). In the last three arguments, n stands forthe number. 


ASCII: American Standard Code for Information Interchange; a 
code in which the numbers from 0 to 127 stand for text characters. It 
is used for representing text inside a computer and for transmitting 
text between computers or between a computer and a peripheral 
device. 


assembly language: A low-level programming language in which 
individual machine-language instructions are written in a symbolic 
form more easily understood by a human programmer than machine 
language itself. 
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auxiliary slot: A special expansion slot inside the Apple lle, used 
for an 80-column text card. 


backing up: The process of making a copy of the information in a 
file or on a disk and putting that copy in another file or on another disk. 


BASIC: Beginners All-purpose Symbolic Instruction Code; a high- 
level programming language designed to be easy to learn and use. 
Two versions of BASIC are available from Apple Computer, Inc. 

for use with the Apple II: Applesoft (built into the firmware of the 
Apple II Plus and Apple lle computers) and Integer (built into the 
Apple II computer). 


binary: The representation of numbers in terms of powers of two, 
using the two digits O and 1. Commonly used in computers because 
the values 0 and 1 can easily be represented in physical form ina 
variety of ways, such as the presence or absence of current, positive 
or negative voltage, or a white or black dot on the display screen. 


bit: A binary digit (0 or 1); the smallest possible unit of information, 
consisting of a simple two-way choice, such as yes or no, on or off, 
positive or negative, something or nothing. 


boot: To start up a computer by loading a program into memory 
from an external storage medium such as a disk. Often done by 

first loading a small program whose purpose is to read the larger 
program into memory. The program is said to “pull itself up by its own 
bootstraps”; hence the term bootstrapping or booting. 


buffer: An area of the computer's memory reserved for a specific 
purpose, such as to hold graphic information or text characters. 
Often used as an intermediary holding area for transferring 
information between devices operating at different speeds, such as 
the computer's processor and a printer or disk drive. Information can 
be stored into the buffer by one device and then read out by the other 
ata different speed. 


byte: A unit of information consisting of a fixed number of bits; in an 
Apple Il, one byte consists of eight bits and can hold any value from 
0 to 255. 


catalog: Alistof all files stored on a disk; sometimes called a 
directory. 


character: A letter, digit, punctuation mark, or other written symbol 
used in printing or displaying information. 
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chip: The small piece of semiconducting material (usually silicon) 
on which an integrated circuitis fabricated. The word chip properly 
refers only to the piece of silicon itself, but is often used for an 
integrated circuit and its package; see integrated circuit. 


code: (1) A number or symbol used to represent some piece of 
information in a compact or easily processed form. (2) The 
statements or instructions making up a program. 


command: Acommunication from the user to a computer system 
(usually typed from the keyboard) directing it to perform some 
immediate action. 


compiler: A language translator that converts a program written in 
a high-level programming language into an equivalent program in 
some lower-level language (such as machine language) for later 
execution. Compare interpreter. 


computer: An electronic device for performing predefined 
(programmed) computations at high speed and with great accuracy. 


copy-protect: To prevent the copying of information recorded 
on a storage medium, such as a disk containing software sold as a 
commercial product. 


connector: Aphysical device, such as a plug, socket, or jack, used 
to connect one hardware component of a system to another. 


control character: A character that controls or modifies the way 
information is printed or displayed. Control characters have ASCII 
codes between 0 and 31 and are typed from the keyboard by holding 
down while typing some other character. 


controller card: Aperipheral card that connects a device, such 
as a printer or disk drive, to the Apple II computer and controls the 
operation of the device. 


cursor: A marker or symbol displayed on the screen that marks 


where the user's next action will take effect or where the next 
character typed from the keyboard will appear. 


data: Information; especially ¡information used or operated on by a 
program. 


data base: A collection of information organized in a form that can 
be processed by a computer system. 
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decimal: The common form of number representation used in 
everyday life in which numbers are expressed in terms of powers of 
ten, using the ten digits O to 9. Compare binary, hexadecimal. 


default: A value, action, or setting that is automatically used by a 
computer system when no other explicit information has been given. 
For example, if a command to run a program from a disk does not 
identify which disk drive to use, DOS automatically uses the same 
drive that was used in the previous operation. 


deferred execution: The saving of a program line for execution at 
a later time as part of a complete program; occurs when the line is 
typed with a line number. Compare immediate execution. 


device: (1) A physical apparatus for performing a particular task 
or achieving a particular purpose. (2) In particular, a hardware 
component of a computer system. 


digit: (1) One ofthe characters 0 to 9, used to express numbers in 
decimal form. (2) One of the characters used to express numbers in 
some other form, such as 0 and 1 in binary or 0 to 9 and A to Fin 
hexadecimal. 


disk: An information-storage medium consisting of a flat, circular, 
magnetic surface on which information can be recorded in the form of 
small magnetized spots, similarly to the way sounds are recorded on 
tape. 


disk controller card: A peripheral card that connects one or two 
disk drives to the Apple ll and controls their operation. 


disk drive: A peripheral device that writes and reads information 
on the surface of a magnetic disk. 


disk envelope: Aremovable protective paper sleeve used when 
handling or storing a disk; must be removed before inserting the disk 
in adisk drive. Compare disk jacket. 


diskette: A term also used for the small (51% inch) flexible disks. 
disk jacket: A permanent protective covering for a disk, usually 
made of black paper or plastic; the disk is never removed from the 
jacket, even when inserted in a disk drive. 

Disk Operating System (DOS): A software system for the Apple II 


that enables the computer to control and communicate with one or 
more disk drives. 
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disk-resident: Stored or held on a disk. 


display: (1) Information exhibited visually, especially on the screen 
of a display device. (2) To exhibit information visually. (3) A display 
device. 


display device: A device that exhibits information visually, such as 
atelevision set or video monitor. 


display screen: The glass or plastic panel on the front of a display 
device on which images are displayed. 


DOS: See Disk Operating System. 

drive: See disk drive. 

80-column text card: A peripheral card that plugs into an Apple 
lle's auxiliary slot and converts the computer's display of text from 
40 to 80 columns. 


envelope, disk: See disk envelope. 


error message: A message displayed or printed that indicates an 
error or problem in the execution of a program. 


execute: To perform or carry out a specified action or sequence of 
actions, such as those described by a program. 


expansion slot: A connector inside the Apple II computer in which 
a peripheral card can be installed; also called peripheral slot. 


file: A collection of information stored as a named unit ona 
peripheral storage medium such as a disk. 


filename: The name under which a file is stored. 


filetype: The one-letter code that characterizes the contents of a 
file and indicates how the file may be used. 


firmware: Those components of a computer system consisting of 
programs stored permanently in read-only memory. Such programs 
(for example, the Applesoft interpreter and the Monitor program) are 
built into the computer atthe factory; they can be executed at any 
time but cannot be modified or erased from main memory. Compare 
hardware, software. 
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fixed-point: A method of representing numbers inside the 
computer in which the decimal point (more correctly, the binary point) 
is considered to occur at a fixed position within the number. Typically, 
the point is considered to lie to the right end of the number, so that the 
number is interpreted as an integer. Fixed-point numbers of a given 
length cover a narrower range than floating-point numbers of the 
same length, but with greater precision. 


flexible disk: A disk made of flexible plastic; often called a floppy 
disk. Compare rigid disk. 


floating-point: A method of representing numbers inside the 
computer in which the decimal point (more correctly, the binary point) 
is permitted to float to different positions within the number. Some of 
the bits within the number itself are used to keep track of the point’s 
position. Floating-point numbers of a given length cover a wider 
range than fixed-point numbers of the same length, but with less 
precision. Compare fixed-point. 


floppy disk: See flexible disk. 


format: (1) The form in which information is organized or 
presented. (2) To specify or control the format of information. (3) To 
prepare a blank disk to receive information by dividing its surface 
into tracks and sectors; also known as initializing. 


hardware: Those components of a computer system consisting of 
physical (electronic or mechanical) devices. Compare software, 
firmware. 


hexadecimal: The representation of numbers in terms of powers 
of sixteen, using the sixteen digits 0 to 9 and A to F. Hexadecimal 
numbers are easier for humans to read and understand than binary 
numbers, but can be converted easily and directly to binary form: 
each hexadecimal digit corresponds to a sequence of four binary 
digits, or bits. 


high-level language: A programming language that is relatively 
easy for humans to understand. A single statement in a high-level 

language typically corresponds to several instructions of machine 
language. BASIC is a high-level language. 


immediate execution: The execution of a program line as soon 


as it is typed; occurs when the line is typed without a line number. 
Compare deferred execution. 
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information: Facts, concepts, or instructions represented in an 
organized form. 


initialize: (1) To setto an initial state or value in preparation for 
some computation. (2) To prepare a blank disk to receive information 
by dividing its surface into tracks and sectors; also called formatting. 


input: (1) Information transferred into a computer from some 
external source, such as the keyboard or a disk drive. (2) The act 
or process of transferring such information. 


integer: A whole number, with no fractional part; represented 
inside the computer in fixed-point form. 


Integer BASIC: Aversion of the BASIC programming language 
that is resident in the Apple II and available with the Apple II Plus 
and Apple lle computers. It is older than Applesoft and processes 
numbers in integer form only. An interpreter for creating and 
executing programs in Integer BASIC is included on the DOS 3.3 
SYSTEM MASTER disk and is automatically loaded into the 
computer's memory when the computer is started up with that disk if 
the computer has enough memory. Compare Applesoft BASIC. 


integrated circuit: An electronic component consisting of many 
circuit elements fabricated on a single piece of semiconducting 
material, such as silicon; see chip. 


interface: The devices, rules, or conventions by which one 
component of a system communicates with another. 


interface card: Aperipheral card that implements a particular 
interface by which the computer can communicate with a peripheral 
device, such as a printer. 


interpreter: A language translator that reads a program written in 
a particular programming language and immediately carries out the 
actions that the program describes. Compare compiler. 


I/O: The abbreviation for input/output; a general term for the 
equipment and process used to communicate with a computer, and 
the information involved in the communication. 


1/O device: Input/output device; a device that transfers information 
into or out of a computer. See input, output, peripheral device. 
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K: Twoto the tenth power, or 1024 (from the Greek root kilo, 
meaning one thousand); for example, 64K bytes equals 64 times 
1024, or 65,536 bytes. 


keyboard: The setof keys built into the Apple II computer, similar to 
atypewriter keyboard, for typing information to the computer. 


kilobyte: A unitof information consisting of 1K (1024) bytes, or 8K 
(8192) bits; see K. 


language: See programming language. 


language translator: Asystem program that reads a program 
written in a particular programming language and either executes it 
directly or converts it into some other language (such as machine 
language) for later execution. 


load: To transfer information from a peripheral storage medium 
(such as a disk) into main memory for use; for example, to transfer a 
program into memory for execution. 


lock: Torestrict the use of file so that it cannot be changed, 
deleted, or renamed. A locked file has an asterisk preceding its 
entry ina DOS catalog. Compare unlock. 


low-level language: A programming language that is relatively 
close to the form that the computer's processor can execute directly. 


machine language: The formin which instructions to a computer 
are stored in memory for direct execution by the computer's 
processor. Each model of computer processor (such as the 6502 
microprocessor used in the Apple II computer) has its own form of 
machine language. 


main memory: The memory component of a computer system 
that is built into the computer itself and whose contents are directly 
accessible to the processor. 


memory: A hardware component of a computer system that can 
store information for later retrieval; see main memory, random- 
access memory, read-only memory. 


memory location: A unit of main memory that is identified by an 


address and can hold a single item of information of a fixed size. In 
the Apple II, a memory location holds one character of information. 
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memory-resident: (1) Stored permanently in main memory, as 
firmware. (2) Held continually in main memory even while not in use, 
as the Disk Operating System. 


menu: A list of choices presented by a program, usually on the 
display screen, from which the user can select. 


microcomputer: A computer, such as the Apple II, whose 
processor is a microprocessor. 


microprocessor: Acomputer processor contained in a single 
integrated circuit, such as the 6502 microprocessor used in the 
Apple Il. 


mode: Astate of acomputer or system that determines its 
behavior. 


modem: Modulator/demodulator; a peripheral device that enables 
the computer to transmit and receive information over a telephone 
line. 


monitor: See video monitor. 


Monitor program: A system program built into the Apple II 
computer that is used for directly inspecting or changing the contents 
of memory and operating the computer at the machine-language 
level. 


nibble: A unit of information equal to half a byte, or four bits. Can 
hold any value from 0 to 15. Sometimes spelled nybble. 


operating system: Asoftware system that organizes the 
computer's resources and capabilities and makes them available 
to the user or to application programs running on the computer. See 
Disk Operating System. 


option: An argument that is optional. 
output: (1) Information transferred from a computer to an external 


destination, such as display screen, disk drive, or printer. (2) The 
process of transferring such information. 


peripheral: Atoroutside the boundaries of the computer itself, 


either physically (as a peripheral device) orin a logical sense (as a 
peripheral card). 
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peripheral card: A removable printed-circuit board that plugs into 
one of the Apple Il’s expansion slots and expands or modifies the 
computer's capabilities by connecting a peripheral device or 
performing some subsidiary or peripheral function. 


peripheral device: An auxiliary piece of equipment that is under 
the control of the computer. Examples of this are printers, cassette 
recorders, and disk drives. 


peripheral slot: See expansion slot. 


printed-circuit board: Ahardware component of a computer or 
other electronic device, consisting of a flat, rectangular piece of rigid 
material, commonly fiberglass, to which integrated circuits and other 
electronic components are connected. 


printer: A peripheral device that writes information on paper. 


processor: The hardware component of a computer that performs 
the actual computations by directly executing instructions 
represented in machine language and stored in main memory. 


program: Asetofinstructions, conforming to the rules and 
conventions of a particular programming language, describing 
actions for a computer to perform to accomplish some task. 


programming language: Asetof rules or conventions for writing 
programs. 


prompt: Toremind or signal the user that some action is expected, 
typically by displaying a distinctive symbol, a reminder message, ora 
menu of choices on the display screen. 


prompt character: A text character displayed on the screen to 
prompt the user for some action. Often also identifies the program or 
component of the system that is doing the prompting; for example, 
the prompt character [ is used by the Applesoft BASIC interpreter, 
> by Integer BASIC, and * bythe system Monitor program. Also 
called prompting character. 


radio-frequency modulator: A device for converting the video 
signals produced by a computer to a form that can be accepted by a 
television set. 


RAM: Seerandom-access memory. 
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random-access memory: Memory in which the contents of 
individual locations can be referenced in an arbitrary or random 
order. This term is often used to refer to read-write memory, but 
strictly speaking both read-only and read-write memory can be 
accessed in random order. Compare read-only memory, read- 
write memory. 


read: To transfer information into the computer's memory from a 
source external to the computer (such as a disk drive) or into the 
computer's processor from a source external to the processor (such 
as the keyboard or main memory). 


read-only memory: Memory whose contents can only be read. 
Information is written to read-only memory once, during 
manufacture; it then remains there permanently, even when the 
computer's power is turned off; it can never be erased or changed. 
Compare read-write memory, random-access memory. 


read-write memory: Memory whose contents can be both read 
and written; often misleadingly called random-access memory, or 
RAM. The information contained in read-write memory is erased 
when the computer's power is turned off and is permanently lost 
unless it has been saved on a more permanent storage medium, 
such as a disk. Compare read-only memory, random-access 
memory. 


resident: See memory-resident, disk-resident. 


rigid disk: A disk made of a hard, nonflexible material. Also called 
ahard disk. Compare flexible disk. 


run: (1) To execute a program. (2) To load a program into main 
memory from a peripheral storage medium, such as a disk, and 
execute it. 

ROM: Seeread-only memory. 


save: To transfer information from main memory to a peripheral 
storage medium for later use. 


screen: See display screen. 


Glossary gee 


scroll: To change the contents of all or part of the display screen by 
shifting information out at one end (most often the top) to make room 
for new information appearing at the other end (most often the 
bottom), producing an effect like that of moving a scroll of paper past 
a fixed viewing window. 


sector: A portion of the recording surface of a disk consisting of a 
fixed fraction of a track. Under DOS 3.3, there are 16 sectors per 
track. 


silicon: A nonmetallic, semiconducting chemical element from 
which integrated circuits are made. Not to be confused with silica— 
that is, silicon dioxide, such as quartz, opal, or sand—or with silicone, 
any of a group of organic compounds containing silicon. 


slot: See expansion slot. 


software: Those components of acomputer system consisting of 
programs that determine or control the behavior of the computer. 
Compare hardware, firmware. 


space character: A text character whose printed representation is 
a blank space, typed from the keyboard by pressing the bar. 


startup disk: Adisk containing software recorded in the proper 
form to be loaded into the Apple II’s memory to set the system into 
operation. Sometimes called a boot disk. 


statement: A unit of a program in a high-level language specifying 
an action for the computer to perform, typically corresponding to 
several instructions of machine language. 


syntax: The rules governing the structure of statements or 
instructions in a programming language. 


system: Acoordinated collection of interrelated and interacting 
parts organized to perform some function or achieve some purpose. 


system program: Aprogram that makes the resources and 
capabilities of the computer available for general purposes, such as 
an operating system or a language translator. Compare application 
program. 


system software: The component of a computer system 
consisting of system programs. 


164 Glossary 


telecommunications: The transmission of information across long 
distances, such as over telephone lines. 


television set: A display device capable of receiving broadcast 
video signals (such as commercial television) by means of an 
antenna. Can be used in combination with a radio-frequency 
modulator as a display device for the Apple II computer. Compare 
video monitor. 


turnkey program: A program, such as a game or application, that 
runs automatically when the disk it is on is started. 


track: A portion of the recording surface of a disk consisting of a 
single circular band at a fixed distance from the center of the disk. 
Under DOS 3.3, there are 35 tracks on a disk. 


unlock: Toremove the restriction on the use of a file so that it can 
once again be changed, deleted, or renamed. Compare lock. 


video monitor: A display device that is capable of receiving video 
signals by direct connection only and which cannot receive 
broadcast signals such as commercial television. Can be connected 
directly to the Apple Il computer as a display device. 


volume: The collection of all the information placed on a disk. 


write: To transfer information from the computer to a destination 
external to the computer (such as a disk drive or printer). 


write-enable notch: The square cutout in one edge of a disk's 
jacket that permits information to be written on the disk. If there is no 
write-enable notch or if the notch is covered, information can be read 
from the disk but not written onto it. 


write-protect: To protect the information on a disk by covering the 
write-enable notch with a write-protect tab, preventing any new 
information from being written onto the disk. 


write-protecttab: Asmall adhesive sticker used to write-protect a 
disk by covering the write-enable notch. 
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